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PREFACE 
This book describes the internal organization and logic of the 
linkage editor. The linkage editor is a processing program that 
combines and edits modules to produce a load module; this load 
module can then be loaded into virtual storage by the control 
program. 

ORGANIZATION 


This publication contains the following: 


® *Introduction™ on page 1, describes the linkage editor as a 
whole, and its relationship to the operating system. This 
section also discusses the major divisions of the program 
and how they work together. 


6 "Method of Operation" on page 15, provides an overview of 
the logic of the linkage editor, and a detailed description 
of specific operations. 

® "Program Organization" on page 89, describes the 
organization of the linkage editor. The function and 
interrelationship of program components (modules, control 
sections, and routines) are also discussed. 

e "Microfiche Directory" on page 146, helps the reader find 
the named areas of code in the program listing. Microfiche 
cards contain the program listing. 


@ "Table Layouts™ on page 151, which are used to analyze 
storage dumps, are illustrated in this section. . 


e "Diagnostic Aids™ on page 183, includes general register 
contents at major entry points to modules, and an error 
message——-module cross-reference table. 


® "Appendix. Conventions/Formats™ on page 194, includes input 
conventions and record formats. 


An index is also included. 


PREREQUISITE KNOWLEDGE 


To use this book efficiently, you should be familiar with the 
following topics: 


® Assembler language functions ane) specifications available 
with Assembler H 


e Job control language 


e General concepts of the linkage editor and loader 
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REQUIRED PUBLICATIONS 


You should be familiar with the information in the following 
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publications: 
® Assembler _H Version 2 Application Programming: Language 


Reference, GC26-4037, for a description of assembler 
language functions 


® MVS/Extended Architecture JCL, GC28-1148, for background 


information on job control language 


® MVS/7Extended Architecture Linkage Editor and Loader User's 


Guide, GC26-4143, for a aesc 


and loader 


RELATED PUBLICATIONS 


iv 


ription of the linkage editor 


Within the text, references are made to the publications listed 


below. 





Assembler H V2 
Application 
Programming: 
Language 
Reference 


Data 
Administration 
Guide 


Data 
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Instruction 
Reference 






Debugging 
Handbook 
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Linkage Editor 
and Loader 
User's Guide 






Note: 


Order 
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Administration: 












Ce E: NVS/Extended Architecture GC28-1148 
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Language Reference 








MVSZExtended Architecture 
Data Administration Guide 





MVS7Extended Architecture 
Data Administration: Macro 
Instruction Reference 












MVS/Extended Architecture LC28-11642 
Debugging Handbook, Volumes LC28-1165 





1 through 5 LC28-1166 
LC28-1167 


LC28-1168 


MVS/Extended Architecture 
ie Linkage Editor and Loader 
User's Guide 


1 All five volumes may be ordered under one order number, 


LBOF-1015. 
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SUMMARY OF AMENDMENTS 


RELEASE 1.0, APRIL 1985 


ENHANCEMENTS AND NEW SUPPORT 


VERSION 2 PUBLICATIONS 


Maximum block size has been increased from 18432 to 32760. 
PCI support for overlay modules has been added to IEWFETCH. 


Error messages IEWN0664, IEW0801, and IEN0813 have been added 
to Figure 68 on page 189 under "Diagnostic Aids." 


Figure 67 on page 188 under "Diagnostic Aids" has been 
updated to reflect changes in table allocation. 


Offsets have been adjusted in Figure 36 on page 152 under 
"Table Layouts." 


The Preface includes new order numbers for Version 2. 
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INTRODUCTION 


This section describes the purpose, organization, and internal 
operation of the linkage editor and its relationship to the 
operating system. 


PURPOSE OF LINKAGE EDITOR 


The linkage editor is one of the processing programs of the 
operating system. It is a service program used in conjunction 
with the ianguage translators to prepare machine-language 
programs frer symbolic-language programs written in FORTRAN, 
COBOL, report program generator, assembler language, or PL/I. 
Linkage editor processing is a necessary step that follows 
source program assembly or compilation. 


Linkage editor processing allows the programmer to divide a 
program into several parts, each containing one or more control 
sections. Each part may then be coded in the programming 
language best suited to it, and may then be separately assembled 
or compiled by a language translator Cunder the rules applicable 
to each language translator). 


The primary purpose of the linkage editor is to combine and link 
object modules (the output of the language translators) into a 
load module. In that load module, all cross-references between 
control sections are resolved as though they had been assembled 
or compiled as one module. The load module produced by the 
linkage editor consists of executable machine-language code ina 
format that can be loaded into virtual storage and relocated by 
program fetch. 


In addition to combining and linking object modules, the linkage 
editor performs the following functions: 


e Library Calls. Modules (such as standard subroutines) stored 
in a library can be placed in the input to the linkage 
editor, either automatically or upon request. If unresolved 
external references remain after all input to the linkage 
editor is processed, an automatic library call routine 
retrieves the modules required to resolve the references. 
However, unresolved external references marked "weak call®™ 
or "never call™ are not resolved by this routine. 


e Program Modification. Control sections can be replaced, 
deleted, or rearranged (Cin overlay programs) during linkage 
editor processing, as directed by linkage editor control 
statements. Common control sections generated by the 
FORTRAN, PL/I, and assembler language translators are 
provided locations within the output load module. 


® Order _and Page Support. The linkage editor can order control 
sections in the sequence specified on the linkage editor 
control statements, and can assign control sections to page 
boundaries according to the control statements. 


e Addressing Mode, Residence Mode, and Read-Only Support. The 
linkage editor assigns an addressing mode for the entry 


Points into a load module, assigns a residence mode for the 
load module, and indicates which control sections are 
read-only ina nucleus load module. 


® Program Processing History. CSECT identification records 
built during linkage editor processing contain data 
describing the language translators and the linkage editor 
that produced the program, any modifications to that program 
by AMASPZAP, and, optionally, up to 40 characters of user 
data for each control section within the program. 
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® Overlay Module Processing. The linkage editor prepares 
modules for overlay by assigning relative locations within 
the module to the overlay segments, and by inserting tables 
to be used by the overlay supervisor during execution. 


® Options and Error Messages. The linkage editor can: 


- Process special options that override automatic library 
calls or the effect of minor errors 


- Produce a list of linkage editor control statements that 
were processed 


—- Produce coded diagnostic messages and a directory 
describing those diagnostic messages that were printed 
out during linkage editor processing 


= Produce a module map or cross-reference table of control 
sections in the output load module 


RELATIONSHIP TO THE OPERATING SYSTEM 


GEN 


ESCRIPTIO 


The linkage editor has the same relationship to the operating 
system as any other processing program. Control is passed to 
the linkage editor in one of three ways: 


l. As a job step, when the linkage editor is specified on an 
EXEC job control statement in the input stream 


2. As a subprogram, via the execution of a CALL macro 
instruction (after execution of a LOAD macro instruction), a 
LINK macro instruction, or an XCTL macro instruction 


3. As a subtask, in multitasking systems, via execution of the 
ATTACH macro instruction 


Linkage editor input may consist of a combination of object 
modules, load modules, and linkage editor control statements. 
The prime function of the linkage editor is to combine these 
modules, in accordance with requirements stated on control 
statements, into a single output load module that can be 
relocated and loaded into real storage by program fetch for 
execution. Output load modules are placed into partitioned data 
sets (libraries). | 


Each module to be processed by the linkage editor has an origin 
that was assigned during assembly, during compilation, or during 
a previous execution of the linkage editor. Each module in the 
input to the linkage editor may contain symbolic references to 
control sections in other modules; such references are called 
external references. 


To produce an executable output load module, the linkage editor: 


1. Assigns relative virtual storage addresses to the control 
sections to be included in the output module. Because each 
input module has an origin that was assigned independently 
by a language translator, the order of the addresses in the 
input is unpredictable. (Two input modules, for example, 
may have the same origin.) The linkage editor assigns an 
origin to the first control section, and then assigns 
addresses to all other control sections in the output 
relative to either this origin or to the last control 
section aligned on a page boundary. 
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2. Resolves external references in the input modules. 
Cross-references between control sections in different 


modules are symbolic, and must be resolved (translated into 


relocatable machine addresses) in relation to the contiguous 


virtual storage addresses assigned to the output load 
module. These symbolic cross-references are made by means 
of address constants. 


The linkage editor calculates the new address of each 


relocatable expression in a control section, and determines the 


assigned origin (value) of the item to which it refers. 


Linkage editor processing is affected by specified options, 
operations requested on control statements, module attributes 
contained in partitioned data set directories, and control 
information contained within the modules themselves. The 
following paragraphs describe the relationship of module 
structure, linkage editor options, and module attributes to 
linkage editor processing. 


Object modules and load modules have the same basic logical 
structure (see Figure 1). Each consists of: 


e Control dictionaries, containing the information necessary 
to resolve symbolic cross-references between control 
sections of different modules and to relocate address 
constants 

e Text, containing the instructions and data of the program 

e An end of module CE0M) indicator CEND record in object 
modules; EOM indication in load modules) 





Input Output 
Object Module Load Module 


N: 


Linkage 


Editor 


Figure 1. Linkage Editor Processing—Simple Case 


Each language translator usually produces two kinds of control 
dictionaries: an external symbol dictionary (CESD) and a 
relocation dictionary (RLD). An object module always contains 
an ESD; a load module contains an ESD unless it is marked with 
the "not editable"™ attribute. Object and load modules usually 
contain an RLD Cunless there are no relocatable address 
constants in the module). Control dictionary entries are 
generated when external symbols, address constants, or control 
sections are processed by a language translator. 
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External Symbol Dictionary 


An external symbol dictionary contains entries for all external 
symbols defined or referred to within a module. (An external 
symbol is one that is defined in one module and can be referred 
to in another.) Each entry identifies a symbol, or a symbol 
reference, and gives its location, if any, within the module. 
When combining input modules, the linkage editor resolves 
references between different input modules by matching the 
referenced symbols to defined symbols; it does this by searching 
for the external symbol definitions in each input module's ESD. 
There is an ESD entry for each named control section and each 
named common area. The ESD also contains entries that identify 
unnamed control sections and unnamed common areas. 


Relocation Dictionary 


The relocation dictionary (RLD) lists all relocatable address 
constants that must be modified when the linkage editor produces 
an output load module. The linkage editor uses the RLD whenever 
it processes a module. The RLD is also used to adjust the value 
of address constants after program fetch reads an output load 
module from a library and loads it into virtual storage for 
execution. The RLD contains at least one entry for every 
relocatable address constant in a module. An RLD entry 
identifies an address constant by indicating both (1) its 
location within a control section, and (2) the external symbol 
Cin the ESD) whose value must be used to compute the value of 
the address constant. 


Composite Dictionaries 


An output load module is composed of all input object modules 
and input load modules processed by the linkage editor (except 
those that are replaced or deleted). The control dictionaries 
of an output module are therefore a composite of all the control 
dictionaries in the linkage editor input. The control 
dictionaries of a load module are called the composite ESD 
CCESD) and the RLD. 


Figure 2 on page 5 shows how the control dictionaries of two 
input modules are combined into composite dictionaries by the 
linkage editor. The control dictionaries and their associated 
text are interrelated through a system of line numbers and 
pointers. Within an input module, each ESD item on which an 
address constant may depend has a line number CESD identifier, 
or ESD ID); the line number indicates the position of the item 
relative to the other ESD items associated with the text.? 

Every item of text in an object or load module has associated 
control information that describes it. This control information 
includes the ESD ID of the ESD item for the control section that 
contains the text. (In Figure 2, the ESD ID of the text item 
that contains X and Y points to line 1 of the ESD for input 
module 1. The ESD ID of the text item containing Z points to 
line 1 of the ESD for input module 2.) 


Each RLD item must point to two ESD items: 


1. The ESD item for the symbol on which the address constant 
depends. This is referred to by the RLD relocation pointer 
CR pointer). 


2. The ESD item for the control section that contains the | 
address constant. This is referred to by the RLD position 
pointer (CP pointer). 


i In an object module, one type of ESD item (CID) may have 
associated text or address constants that depend on it (see 
“ESD Processing"). Such ESD items are excluded from the 
numbering system. 
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*See ''ESD Record Types’’ 


Figure 2. Combining Control Dictionaries 





In input module 1, X and Y are address constants in the same 
control section (CSECT A). xX refers to a symbol in CSECT A; 
therefore, both pointers of its associated RLD item refer to the 
ESD entry for CSECT A Cline 1). The value field of Y refers to 
a symbol ina different control section (CSECT C); therefore, 
the R pointer of its associated RLD points to the ESD entry for 
the external reference (line 2), whereas the P pointer refers to 
the ESD entry for its control section (line 1). 


When the linkage editor combines the input modules, it must 
maintain this system of pointers by renumbering the ESD items to 
reflect their relative positions in the CESD of the output 
module. It must also update the RLD pointers and control 
information for the text so that they refer to the renumbered 
ee ee the resulting CESD and RLD items are shown in 

igure 2. 


LINKAGE EDITOR OPTIONS 


Options for error diagnostics, processing, and space allocation 
may be specified by parameters listed on the EXEC card, or they 
may be passed internally by a program requesting the linkage 
editor via LINK, LOAD, ATTACH, or XCTL macro instructions.* If 
the options are passed internally, the user can also provide 


é For more information, see Data Administration Guide and Data 
Administration: Macro Instruction Reference. 
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alternates for the standard ddnames.* If the options are not 
user-specified, the defaults are used. The options that may be 
specified are as follows: 


® LIST. A list of all linkage editor control statements is 
written on the diagnostic output data set. 


e MAP. A module map, which lists external names and their 
a ce addresses, is written on the diagnostic output data 
set. 


6 Cross-reference table (XREF). <A cross-reference table, 
which includes a module map and a list of all address 
constants that refer to other control sections, is written 
on the diagnostic output data set. 


® TERM. Error messages are directed to the terminal data set 
as well as to the diagnostic output data set. 


e LET. The output module is marked as executable even though 
a severity 2 error condition was found during processing. 


° Exclusive call (XCAL). The output module is marked as 
executable even though valid exclusive references between 
overlay segments have been made. 


° No automatic library call CNCAL). The automatic library 
call mechanism is not to be invoked to resolve external 


references. 
6 SIZE (value 1, value 2). The user can supply two values to 


specify (1) the maximum amount of storage to be obtained for 
linkage editor processing and (2) what amount of the gotten 
storage is to be used as the load module buffer. 


° DCBS. The linkage editor initialization routine examines 
the SYSLMOD DD statement for a DCB BLKSIZE parameter and 
uses that value, if it is acceptable, for its block size 
limit. If the DEVTYPE capacity is less than the specified 
block size, the DEVTYPE value is used. 





When the linkage editor generates a load module in a library 
partitioned data set (PDS), it places an entry for the module in 
the PDS directory. This entry contains "attributes" describing 
the structure, content, and logical format of the load module. 
The control program uses these attributes to determine how a 
module is to be loaded, what it contains, whether or not it is 
executable, whether it is executable more than once without 
reloading, and whether it can be executed by concurrent tasks. 


Some options for module attributes can be specified by the user; 
others are specified by the linkage editor as a result of 
information gathered during processing. In the following list, 
peaieras marked with an asterisk (%) cannot be specified by 

e user: 


e Reenterable CRENT). A reenterable module can be executed by 
more than one task at a time, and cannot be modified by 
itself or by any other module during execution; that is, a 
task may begin executing a reenterable module before a 
previous task has finished executing it. 


6 Refreshable (REFER). A refreshable module cannot be modified 
by itself or by any other module during execution. 
refreshable module can be replaced by a new copy during 
execution by a recovery management routine, without changing 
either the sequence or results of processing. 


3 For more information, see JCL. 
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Serially reusable (REUS). A serially reusable module will 
be executed by only one task at a time, and will either 
initialize itself and/or will restore any instructions or 
any data in the module that it alters during its execution. 


Overlay format COVLY). A load module structured for overlay 
includes a segment table (SEGTAB) to enable the overlay 
supervisor to load the proper segments, and at least one 
ENTAB to assist in passing control from one segment to 
another. If a load module has the overlay format attribute, 
the reenterable, reusable, refreshable, hierarchy, scatter, 
addressing mode, and residence mode attributes cannot be 
present. | 


Hierarchy format (CHIAR). When a HIARCHY statement is 
detected, the “"number®™ and "name™ operand values are used in 
building the scatter table and the translation table. The 
high-order byte of each CSECT address entry contains the 
hierarchy number that is included in the GETMAIN request for 
main storage for program loading. Hierarchy information is 
used only when the program is loaded under the OS system. 


Test (TEST). If this module is an assembler language 
program and testing by the test translator or the TSO TEST 
command is desired, this attribute can be specified. Test 
will cause SYM records to be written. Note that modules 
using TESTRAN should not be marked with the RENT, REUS, or 
REFR attribute. 


Only loadable (OL). This attribute indicates that the 
control program may load this module only through the 
execution of the LOAD macro instruction. 


Scatter format (SCTR). In the OS environment, a load module 
in scatter format is suitable for block or scatter loading. 
The scatter table, translation table, and the relocation 
dictionary maintain logical linkage between scattered 
control sections when program fetch loads them into storage. 
In the virtual storage environment, the scatter format is 
ignored by program fetch. The SCTR attribute is, however, 
relevant in the link-editing of a nucleus for a virtual 
storage system, which requires the scatter and translate 
tables for its proper initialization. 


ALIGN2. If the ALIGN2 attribute is present, all control 
sections or named common areas specified on the PAGE control 
statements are placed in storage on 2K-byte page boundaries. 
The ALIGN2 attribute also aligns, on 2K-byte page 
boundaries, those control sections or named common areas 
associated with the "P"™ operand on the ORDER control 
statement. 


X¥Block format. If neither the overlay nor scatter 
attributes are specified, it is implied that the module can 
only be block loaded. The control program will load the 
module only if enough contiguous storage is available for 
the entire module. 


XExecutable. This attribute indicates that linkage editor 
did not find any errors that would prevent successful 
execution. If this attribute is not present, the control 
program will not load the module. 


XModule contains one text record and no relocation 
dictionary records. This attribute indicates that the 
control program does not have to allocate storage for 
relocation dictionary items when loading the module. It 
also indicates that the first text record is the last one; 
there is no control record following it. The entire module 
can be read by program fetch in a single read operation. 


Downward compatible (DC). This attribute indicates that the 
module can be processed by either the level E or level F 
linkage editor. The downward-compatible attribute is 
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assumed by the level E linkage editor. Modules processed by 
the level F linkage editor that are not marked "downward 
eat cannot be processed by the level E linkage 
editor. 


® X¥Linkage editor assigned origin of first text record is 
zero. If this attribute is present, the first byte of 
instruction or data in the first text record is assigned to 
location zero. 


e xEntry point assigned by linkage editor is zero. This 
attribute indicates that the entry point is at the first 
byte of the module. 


@ X¥No relocation dictionary items present. This attribute 
indicates to the control program that no allocation of 
storage 1s necessary to receive relocation dictionary items 
when program fetch loads them into virtual storage. 


e Not editable (NE). This attribute indicates that the load 
module cannot be accepted by the linkage editor for 
subsequent processing. The CESD from an output load module 
is dropped to conserve space on the library. 


® ¥Symbol statements present. If a module produced by the 
assembler language translator is to be tested by the test 
translator CTESTRAN) or the TSO TEST command, it may contain 
a testing symbol dictionary. In a load module, this 
dictionary contains the information from the SYM statement 
images that were in the input to the linkage editor. 


) Authorization Code (AC). The output load module is assigned 
an authorization code that determines whether or not the 
load module may use restricted system services and 
resources. 


e Addressing Mode (AMODE). The entry points—either main, 
true alias, or alternate—into the output load module are 
assigned the addressing mode that is to be in effect when 
the load module is entered at those entry points. 


® Residence Mode (RMODE). The output load module is assigned 
the residence mode that applies to that load module when it 
is loaded into virtual storage for execution. 


e *XRead-Only Control Section. "Read-only" is an attribute of 
a control section deliberately created as such by 
specification of the control section as an RSECT to the 
language translator. The attribute is effective only when 
the control section is included in the nucleus load module 
for an MVS/XA system; otherwise it is ignored. The 
attribute is obtained from the ESD entries for the read-only 
control sections, and is reflected in the scatter table 
ba for those control sections in the nucleus load 
module. 


LINKAGE EDITOR PROCESSING FOR ATTRIBUTES 


Several examples are given here of how linkage editor processing 
is affected by attributes specified by the user. Figure 1 on 
page 3 shows a simple case in which a single object module, 
containing only one control section, is processed by the linkage 
editor for block loading. 


Figure 3 on page 9 shows the processing of an object module and 
a load module, each containing several control sections. In 
this example, test translator macro instructions were included 
in an assembler language source program, and test symbol (SYM) 
records were produced by the assembler language translator. The 
TEST and OVLY attributes were specified in the control 
information passed to the linkage editor, and overlay control 
statements were included in the input to the linkage editor. 
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With these attributes, the output load module produced by the 
linkage editor contains: 


° SYM records to be used by the test translator. CIf the TEST 


attribute is not specified, input SYM records are not 


included in the output load module.) These records contain 


blocked SYM and ESD statements created during a previous 
execution of the linkage editor. SYM records in load 


modules are passed unmodified through the linkage editor to 


the output load module. 


e A_ composite ESD. CESD records contain the ESD items for the 


module. There is a maximum of 15 ESD items per record on 
the output record. The first 8 bytes of the CESD record 


contain control information pertaining to the ESD items in 


the record. This information consists of the ESD ID of the 


first ESD item and the number of bytes of ESD items in the 


record. 
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* RLD items exist for previous TXT records; therefore, EOM/RLD follows TXT record. 
** No RLD items for last TXT record; therefore, EOM precedes TXT record. 
Note -- Any overlay tables in the input load module ere ignored. 
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Figure 3. Linkage Editor Processing for the Overlay and TEST Attributes 
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e CSECT Identification Records (IDR). The IDRs are input from 
either an input load module, an END record, or the linkage 
editor IDENTIFY control statement. IDRs may contain data: 


- Identifying the language translator creating the control 
section, its level, and the translation date 


a Describing the most recent processing by the linkage 
editor 


- Describing any modification to the executable code of a 
control section | 


- Supplied by a user and associated with the executable 
code of a control section 


Notes The user-supplied data is specified on the IDENTIFY 
control statement. 


6 A control record, or a composite control/RLD record, 
preceding each text record. The RLD portion, if present, 
contains the RLD items used to relocate the previous text. * 
The control portion may contain: 


= An end of segment (CEOS) indication, if the following 
text record is the last text record of an overlay 
segment> 


= An end of module (CEOM) indication, if the following text 
record is the last text record of the module? 


a The number of bytes of RLD information that follow, if 
it is a composite control/RLD record 


a The number of bytes of control information 


The control portion also contains the IDs and lengths (Cin 
bytes) of all the control sections in the following text, to 
a maximum of 60, and a channel command word (CCW). The 
channel command word contains the address assigned by the 
linkage editor to the first byte of that record, plus the 
total length of the record. This information is used by 
program fetch to read the following text. 


Note: The control portion contains as many IDs and lengths 
as there are control sections in the following text record. 


® Text for each control section. Text records contain the 
instructions and data for the module. In overlay, the 
linkage editor produces two special types of text records, 
the segment table (SEGTAB) and entry table CENTAB). 


SEGTAB, located in the root segment, is used by the overlay 
supervisor to keep track of the relationship of segments 
during execution. ENTAB is a separate control section that 
may be created by the linkage editor for each overlay 
segment. ENTAB is used by the overlay supervisor to 
determine the segment to be loaded when a segment not in the 
current path is referred to. 


e A note list. <A note list gives the location of each overlay 
segment in the output module library. 


4 If there are many RLD items for the previous text, there may 
be several RLD records preceding the next text record. The 
last of these is a control/RLD record. 


5 If there are no RLD items for the last text record, the 
control record that precedes the text contains the EOS or 
EOM indication. If there are RLD items, the EOS or EOM 
follows the text record (see Figure 3 on page 9). 
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Figure 4. Linkage Editor Processing for the Scatter Load and TEST Attribute 


Figure 4 shows the module structure when the scatter load and 
TEST attributes are requested. With these attributes, the 
output load module contains: 


® SYM records. 
e A composite ESD. 
® IDR records. 


e A scatter/translation record used by program fetch to 
compute the relocated addresses required for scatter loading 
the module into storage. The record contains a scatter 
table and a translation table. The scatter table is a list 
of control section addresses; the translation table 
correlates the CESD entry for each control section with the 
address indicated in the scatter table. (When a load module 
in scatter format is processed again by the linkage editor, 
this information is ignored. ) 


® Text for each control section, preceded by a control or 
control/RLD record describing it. 


® RLD or control/RLD records containing any RLDs pertaining to 
the preceding text record. 


® An EOM indication that marks the end of the module. 


The appendix "Input Conventions and Record Formats" contains 
the format of each record type. 


INPUT/OUTPUT FLOW 


Four data sets must be specified for linkage editor processing; 
their ddnames and functions are: 


1. SYSLIN. This is the "primary input data set" containing 
object modules and control statements. All input from 
SYSLIN must be in 80-column card image format, unblocked or 
blocked, from 1 to G0 records per block. The SYSLIN source 
may be a card reader, magnetic tape, a direct access device, 
or a concatenation of data sets from different types of 
input devices. 
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2. SYSPRINT. This is the "diagnostic output data set.” 
Diagnostic messages as well as any diagnostic options 
requested, such as a module map or cross-reference table, 
are written on SYSPRINT. It is a sequential data set and 
may be partitioned. The SYSPRINT device may be a printer, 
magnetic tape, terminal, or a direct access device. 


3. SYSUTL. This is the "intermediate data set." The linkage 
editor uses this data set for temporary storage of text and 
RLD items being processed. SYSUT1 must be ona 
direct-access volume. 


Note: SYSUT1 is opened only when twopass processing is in 
effect. 


G4. SYSLMOD. This is the "output module data set." It is a 
partitioned data set on a direct-access volume. SYSLMOD 
contains load modules; their attributes are described in the 
user's portion of the directory entry for the member. 


Two additional data sets may be specified for linkage editor 
processing; their ddnames and functions are: 


_ @ SYSTERM. This is the "terminal data set." Diagnostic 
messages are written on SYSTERM if the TERM option was 
specified. When the linkage editor is being executed in the 
time-sharing foreground, the SYSTERM device is always the 
terminal; when the linkage editor is being executed in the 
background, the SYSTERM device may be a printer, magnetic 
tape, or a direct-access device. 


6 SYSLIB. This data set is used by the linkage editor if 
there are any automatic library calls to be processed. 
SYSLIB can be defined only as a partitioned data set (PDS). 
The members of SYSLIB can be either load modules or object 
modules (but object modules and load modules cannot be 
contained in the same PDS, and a data set containing load 
modules cannot be concatenated with a data set containing 
object modules). 


When SYSLIB is opened, the linkage editor determines whether 
the PDS contains object or load modules by checking the 
record format field CRECEM) in the data control block CDCB). 
(The format is fixed (CF) for object modules and undefined 
CU) for load modules. Load module records are of variable 
length.) If SYSLIB contains object modules, the linkage 
editor ignores the user's portion of the PDS directory 
entries for the object modules. 


Other data sets may be read by linkage editor when it processes 
INCLUDE or LIBRARY statements specifying ddnames. Data sets 
referenced with INCLUDE statements may be either sequential or 
partitioned. SYSLIB, and any data sets specified in LIBRARY 
statements for use by automatic library call, must be 
partitioned. 


The attributes for the "execute linkage editor" job step are the 
attributes specified on the EXEC statement. These attributes 
may be modified if a load module having different attributes is 
processed. 


Figure 5 on page 13 shows the input/output flow. During the 
initial processing, SYSLIN, SYSPRINT, SYSLMOD, and SYSTERM (if 
the TERM option was specified) are opened. During input 
processing, the primary input is read from SYSLIN. If an 
INCLUDE statement is read in the primary input, the data set 
whose ddname is specified on the statement is opened and 
processed. At the end of all SYSLIN input, SYSLIB and any other 
data sets whose ddnames are specified on LIBRARY statements are 
processed through automatic library calls. 
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Figure 5. Input/Output Flow 


If the TEST attribute has been selected, SYM records are written 
during input processing; text and RLD items are written 
sequentially on SYSUT1, except during single pass processing. 
The location of each text record on SYSUT] is entered ina text 
note list. The location of each RLD record on SYSUT1 is entered 
ina RLD note list. If either note list overflows, a table 
overflow message CIEW0364) will be issued. 


In intermediate processing, the CESD is written on SYSLMOD. If 
a scatter table, translation table, or SEGTAB is required, it is 
also written on SYSLMOD. The note list for the text and RLD 
items on SYSUT1 are read into storage. If a module map was 
required, the CESD is used in producing the map. If a 
cross-reference table was requested and all RLDs are in storage, 
the table is produced during intermediate processing. 


During second pass processing, text and RLD records are read 
into storage from SYSUT1 in the order of assigned addresses 
within each segment Cusing the note lists to find the records), 
and are written out on SYSLMOD. 
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In final processing, the member name and any aliasS names are 
entered into the PDS directory entry for the output load module 
through the execution of the STON macro instruction. If any 
coded diagnostic messages were written on SYSPRINT during 
linkage editor processing, a diagnostic message directory 
containing error message text is written out on SYSPRINT. If a 
cross-reference table was requested and was not produced during 
intermediate processing, SYSLMOD is opened for input, RLDs are 
read, and the cross-reference table is produced. At the end of 
final processing, SYSLMOD is closed (if it was opened for 
input). All other data sets are then closed and control is 
returned to the calling program, unless the SYSLIN input during 
input processing was terminated by a NAME statement. If a NAME 
statement terminated the primary input, control is returned to 
initial processing, and SYSLMOD is opened for output if it had 
been closed during final processing. 


When multiple load modules are produced in a single execution of 
the linkage editor, SYSLIN, SYSPRINT, and SYSUT1 remain open for 
the entire execution. CA pointer in the BCB for SYSUTl is 
repositioned to the beginning of the extent of SYSUT1] after each 
load module is produced.) If neither a module map nor a 
cross-reference table is requested, or if a cross-reference 
table is requested and all RLDs are in storage, SYSLMOD remains 
open for output for the entire linkage editor execution. 
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METHOD OF OPERATION 


This section contains an introduction to the logic of the 
linkage editor, emphasizing the flow of primary data and control 
information through tables and buffers, and providing functional 
descriptions of its phases. 


LOGIC OF THE LINKAGE EDITOR 


Initialization 


Input Processing 


The linkage editor can be functionally divided into five phases: 
e Initialization 

e Input (first pass) processing 

e Intermediate (first pass) processing 

° Second pass processing 

e Final processing 


Operation diagrams at the end of this section illustrate the 
functional operation of the linkage editor. The shaded areas of 
the diagrams correspond to operations described in the text. 


When the linkage editor receives control from the job scheduler 
or a calling program, it performs initialization functions in 
preparation for all subsequent processing (see "Diagram 3. 
Initialization" on page 77). The operations included in 
initialization are: 


® Build the all-purpose table CAPT) and enter addresses and 
descriptions of all other tables and buffers into it. 


e Analyze the attributes and options passed by the calling 
program (specified by the programmer), and save them in the 
all-purpose table. 


° Initialize DCBs and open data sets to be used during linkage 
editor processing. 


° Allocate storage for all tables, buffers, and work areas to 
be used by linkage editor processing. 


When all initialization functions are completed, the linkage 
editor is ready to accept input. 


All linkage editor input is processed initially during the first 
pass (see "Diagram 4. Input Processing™ on page 78). Object 
modules from SYSLIN Cprimary input data set) are read into the 


SYSLIN buffer. Object modules from SYSLIB or a specified user's 


library (secondary input data sets) are read into the object 
module buffer. Text records in load modules from SYSLIB or a 
user's library are read into the input text buffer; all other 
load module records are read into the first pass RLD buffer. 
ee eee records that constitute these modules are processed 
as follows. 


Control Statements: These records, which may precede or follow 


object modules, contain information that is later used in symbol 
resolution and that specify libraries containing secondary 
input. Depending on the type of control statement, entries are 
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made in either the all-purpose table CAPT) or the composite 
external symbol dictionary (CESD). 


ESD Records: These records from object modules, and CESD 
records from load modules, describe symbols that have been 
defined for external use. Entries for the symbols are made in 
the CESD. Entries are made in the renumbering table to allow 
the translation of the input ESD identifiers (IDs) into new CESD 
IDs. Entries are made in the delink table for symbols that are 
to be deleted or replaced. 





TXT Records: These records, containing the instructions and 
data of the program, are moved from the SYSLIN buffer and object 
module buffer to the input text buffer (text records from load 
modules are read directly into the input text buffer). They are 
arranged in the proper sequence and recorded in the text I/0 
table and the text note list. When the input text buffer is 
filled, its contents are written onto SYSUTI1; if it does not 
become filled, text records are retained in the buffer and 
"single pass" processing 1s in effect. Text note list entries 
contain the location of text records (SYSUT] address or buffer 
address) and other descriptive information. Text I/0 table 
entries contain information identifying text records by ESD ID. 


RLD Records: These records, to be used later in relocating 
address constants, are moved from the SYSLIN buffer and object 
module buffer to the RLD buffer. The relocation and position 
pointers (R and P pointers) are updated, using control 
information from the renumbering table and the delink table. 
RLD items are examined and marked for future processing. If 
V-type (branch-type) address constants are found in overlay 
programs, entries are made in the call list for use during 
intermediate processing. When the RLD buffer is full, RLD 
records are written on SYSUT1, and control information 
identifying RLD records by size (byte count), P pointer, and 
location on SYSUT1 is entered in the RLD note list. If the RLD 
buffer does not become filled, RLD records are retained in the 
buffer and single pass processing is in effect. 


SYM Records: These records, which are not involved in linkage 
editor processing, are gathered in the RLD buffer and are 
written directly on SYSLMOD if the TEST attribute has been 
iar If TEST has not been specified, SYM records are 
ignored. 


IDR Records: These records, which contain data either from an 
input load module, an END record, or the linkage editor IDENTIFY 
control statement, supply information concerning the processing 
history of the modules in which the IDRs occur. If the data is 
from an input load module, control is passed to the IDR 
processor HEWLFIDR. If the data is from an END record, the data 
refers to the compiler that created the object module. The 
compiler or translator data is passed in a parameter list to the 
IDR processor. The user data, supplied via the linkage editor 
IDENTIFY control statement, is converted into a parameter list 
and passed to the IDR processor. 


Hhen all input records have been processed (all external symbols 
have been entered into the CESD), control is passed to 
intermediate processing. 


Intermediate Processing 


The operations included in intermediate processing (see "Diagram 
5. Intermediate Processing™ on page 79) have two primary 
objectives: (1) to assign relative storage addresses to symbols 
in the CESD and (2) to write some of the records to be included 
in the output load module on the SYSLHMOD data set. The MAP and 
XREF options may also be processed during intermediate 
processing. 
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Address Assignment: Entries that require no further processing 
are Bee Geiatcd from the CESD; all other CESD symbols are assigned 
temporary linked addresses. Relocation constants are determined 
for all control sections, and the relocation constant table 
CRCT) is built. 


For all programs in overlay, additional processing is required. 
The calls list is used to determine ENTAB entries to be placed 
in the CESD, and the downward calls list is built. The segment 
length table (CSEGLGTH) is built, t, and segment relocation 
constants are computed. Temporary linked addresses in the CESD 
and entries in the relocation constants are computed. Temporary 
linked addresses in the CESD and entries in the relocation 
constant table are adjusted for overlay by adding to them the 
segment relocation constants. 


Temporary linked addresses and relocation constants are combined 
to determine final linked addresses for symbols, and the results 
are placed in the CESD. The alias table is built from alias 
pace en in the CESD. At this point, CESD processing is 
complete. 


MAP/ZXREF Processing: If the MAP option has been specified, and 
enough table space is available, a module map containing sorted 
CESD items is built and written on SYSPRINT. If the XREF option 
has been specified and all RLDs are in storage, a 
cross-reference table is built from RLDs Cin the RLD buffer) and 
written on SYSPRINT. If all RLDs are not in storage, or the MAP 
table size is insufficient, the cross-reference table is not 
built but is deferred until final processing. 





Intermediate Output: The principal function of this section of 
intermediate processing is to write the CESD on the output load 
module data set (SYSLMOD). The half ESD CHESD), containing 
control information from CESD entries, is built and held in 
storage for use during second pass processing. The text I/0 
table is reorganized according to the sequence in the order 
table, and scanned to determine the ID of the last control 
section containing text in the program Cor in each segment of an 
overlay program); this information is placed in the high ID 
table CHIID), and noted in the HESD for use during second pass 
processing. 


For a program in overlay, the segment table CSEGTAB), which 
defines the relationships among segments, is built and written 
(with a control record) on SYSLMOD. 


For a program that is to be scatter loaded in the OS environment 
(MFT or MVT), a scatter table and a translation table are built 
from information in the CESD, and scatter/translation records 
are written on SYSLMOD. 


The IDRs are written out on the output load module data set 
CSYSLMOD). 


Second Pass Processing 


The objectives of second pass processing (see "Diagram 6. Second 
Pass Processing” on page 80) are (1) relocating address 
constants in the text and (2) writing on the SYSLMOD data set 
the remaining records that constitute the output load module. 


Text records are read from SYSUT1 Cintermediate data set) into 
the second pass text buffer, using the text J/0O table and the 
text note list to locate the records on SYSUT1. The text J/0 
table is also used to determine the order in which text records 
are to be processed. RLD records associated with the text being 
processed are read into the second pass RLD input buffer, using 
the RLD note list to locate the required records. 
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Single Pass Processing: If the linkage editor did not write 
text or RLD records on SYSUT1, single pass processing is in 
effect for these records. The records are accessed directly in 
the input text buffer and the RLD buffer, which are physically 
the same storage areas as the second pass RLD input buffer. If 
text records or RLD records were written on SYSUT1, they are 
read back into the same locations. 


Relocation: Address constants described by RLD items are moved 
from the second pass text buffer to a work area, where 
relocation is performed. The manner in which each address 
constant is relocated depends on whether it is a V-type 
Cbranch-type) or an A-type Cnonbranch-type) address constant, or 
@ pseudo register (type 1 or type 2) 


The V-type address constant can refer to a named location in 
some other control section (branch type address constant). The 
value field of such a V-type address constant always contains a 
zero because the address was not known at compilation time. 


During second pass processing, the linkage editor address 


Cabsolute relocation factor) that was assigned to the symbol and 
saved in the HESD is inserted in the value field. This is 
called absolute relocation. 


If the V-type address constant is in an overlay program, the 
address of an ENTAB entry for the symbol and the segment number 
of the current text is inserted in the value field. CENTABs are 
created in the second pass RLD buffer from information in the 
HESD and the entry list, which contains an entry for each V-type 
address constant in the path of a referred-to symbol.) 


The value field of an A-type address constant that refers to a 
named location in the same input module (nonbranch-type address 
constant) contains an address assigned by the language 
translator. During second pass processing, this address is 
modified by adding or subtracting the relative relocation factor 
that was determined for the symbol referred to by the address 
constant. Relative relocation factors are saved in the 

ie peal constant table. This process is called relative 
relocation. 


When each address constant is relocated, it is placed back in 
the text, and the address field of the associated RLD item is 
updated. The RLD item is then moved to the second pass RLD 
output buffer. When all address constants in the text buffer 
are relocated, the text is written on SYSLMOD, followed by the 
associated RLD items. A control record pertaining to the next 
text record is written on SYSLMOD following the RLD records. If 
the output load module is structured for overlays, a TTR list, 
containing the address of the first control record of each 
segment (for the first segment, the list contains the address of 
se first text record) is also created and retained in virtual 
storage. 


Second pass processing continues until all segments in the 
output module are processed. The last control record contains 
end-of-module indicators. Control is then passed to final 
processing. 


The objectives of final processing (see "Diagram 7. Final 
Processing™ on page 81) include writing remaining output to 
SYSLMOD, producing certain optional output, and "cleanup" 
functions. 


The partitioned data set directory for SYSLMOD is completed, 
including modifications for ALIAS symbols (found in the ALIAS 
table), and a STOW macro is issued. The TTR list, containing 
the address of the first text record in each segment, is written 
on SYSLMOD for overlay programs. 
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The error loaging map, produced as errors are encountered 
throughout linkage editor processing, is scanned and an error 
diagnostic directory is built and written on SYSPRINT. If the 
TERM option was specified, the error diagnostic directory is 
also written on SYSTERM. Storage allocated to the linkage 
editor is released. 


If the MAP or XREF option is specified and was not processed 
during intermediate processing, RLD records are read from 
SYSLMOD, and a cross-reference table is built and written on 


SYSPRINT. If the alternate NAP table is too small, warning 
message IEW0801 will be issued. 


At the completion of linkage editor processing, control is 
returned to the calling program. 


INITIALIZATION 


The initialization phase comprises modules HEWLFINT, HEWLFOPT, 
and HEWLFDEF. 


When the linkage editor begins processing, it readies the 
all-purpose table, analyzes control information, opens necessary 
data sets, and allocates space to buffers and tables. 


PREPARING THE ALL-PURPOSE TABLE (APT) 


The linkage editor maintains the all-purpose table as the common 
communication area for all internal functions (see Figure 27 on 
page 68 for the contents of the all-purpose table). The basic 
information in the all-purpose table is added to during 
initialization as operating conditions are learned. This 
information includes the results of the control information 
analysis and descriptions of the tables and buffers built by the 
linkage editor. 


ANALYZING CONTROL INFORMATION 


When the linkage editor receives control from the job scheduler, 
or from another program via a CALL macro instruction, control 
information may be passed to it. This information includes the 
options that control linkage editor processing, and the 
attributes to be assigned to the output load module. A calling 
program may also provide a substitute list of ddnames to be used 
in place of the standard names, and a PDS directory name for the 
output load module. 


During initialization, the specified attributes and options are 
interpreted, checked for validity against an attribute-option 
table, and recorded in the all-purpose table. When options with 
associated values are recognized, the linkage editor also saves 
the value in the all-purpose table. (For example, the SIZE 
option gives user-chosen values to be used instead of the 
default values. ) 


Besides being checked for valid specification, the attributes 
and options are also checked to ensure that they are requested 
only in allowable combinations. When mutually exclusive 
attributes or options are noted, the dominant attribute or 
dips is retained; the other 1S ignored (see Figure 6 on 

page 20). 


IDR Records: These records, which contain data either from an 
input load module, from an END record, or from the linkage 
editor IDENTIFY control statement, supply information concerning 
the processing history of the modules in which they occur. 

the data is from an input load module, control is passed to the 
IDR processor, HEWLFIDR. If the data is from an END record, the 
data refers to the compiler that created the object module. The 
compiler or translator data is passed in a parameter list to the 
IDR processor. The user data supplied via the linkage editor 
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IDENTIFY control statement is converted into a parameter list 
and passed to the IDR processor. 





oC 0 
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Note: An X indicates incompatible attributes; the attribute that appears lower on the list is 
ignored. For example, to check the compatibility of XREF and NE, follow the XREF column 
down and the NE row across until they intersect. Because an X appears where they intersect, 
they are incompatible attributes. NE is ignored. 


Figure 6. Incompatible Module Attributes and Program Options 


After the standard ddnames (or passed ddnames) have been entered 
into the proper DCBs, the data sets always required for linkage 
editor operation are opened. These are the SYSLIN, SYSPRINT, 
and SYSLMOD data sets. If the TERM option was specified, the 
SYSTERM data set is also opened. 


Note: SYSLIB is opened during input processing if automatic 
library calls or INCLUDE statements are recognized. SYSUTl is 
opened only for twopass processing. 


When SYSLIN is opened, the “unlike attributes" indicator in the 
associated DCB is set to signify that SYSLIN may be a 
concatenation of data sets with varying blocking factors. 


In preparation for the opening of the SYSLMOD data set, the 
linkage editor obtains storage for the JFCB for the data set and 
reads the JFCB into that storage. From the JFCB, the linkage 
editor obtains the data set disposition and the block Size, in 
‘case the DCBS option is specified. The block size in the JFCB 
is zeroed in order to obtain the DSCB block size when the data 
set is opened. 
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In addition, a DEVTYPE macro instruction is issued to obtain the 
maximum block size for the type of device on which the SYSLMOD 
data set resides. The value obtained will be used subsequently 
in determining the output block size. 


If the SYSLMOD data set resides on a shared device and if the 
data set is not a temporary data set, the linkage editor 
reserves the shared device for the duration of the job step. If 
the SYSLMOD data set does not reside on a shared device but a 
disposition of SHR was specified for it on the SYSLMOD DD 
statement, the linkage editor enqueuves the SYSLMOD data set for 
the duration of the job step. 


The SYSLMOD data set is opened with an OPENJ macro instruction, 
specifying the JFCB previously read and modified. 


During the opening of the SYSLMOD data set, the block size to be 
used for output to the data set is determined in the open exit 
routine. The appropriate block size is selected considering the 
following factors: The value obtained from the DEVTYPE macro 
instruction, establishing the absolute maximum block size; the 
block size in the DSCB for an existing data set, which can be 
increased but not decreased; the block size from the SYSLMOD DD 
statement, when the DCBS option is used; the implied maximum 
block size of 1024, when the DC option is used; the implied 
minimum block size of 1024, when the SCTR option is used; the 
absolute minimum block size of 256. 


ALLOCATING VIRTUAL STORAGE 


Buffer Allocation 


To obtain storage for buffers and tables, the linkage editor 
issues the GETMAIN macro instruction specifying the minimum 
amount of additional virtual storage required for operation. 
The minimum provides for overlay or hierarchy tables if these 
options are selected, and, for an area, a 12K-byte block of 
storage that is returned by means of a FREEMAIN macro 
instruction for use by system and data management functions. 
The minimum also includes the added space required for the 
primary input buffer when the SYSLIN data set contains blocked 
records. If the minimum is not available, control is not 
returned to the linkage editor; instead, a system abnormal 
termination occurs. 


When the supervisor returns virtual storage space, the linkage 
editor determines whether the area is sufficient to use maximum 
lengths for the SYSLIN, SYSPRINT, and object module buffers. If 
the space is not sufficient, intermediate or, when necessary, 
minimum buffer lengths are used. 


The RLD and text buffers are then assigned storage. The default 
text buffer length (48K bytes) is used unless a specific 
allocation was requested via the SIZE parameter. The RLD buffer 
is also assigned the minimum length, unless the SIZE parameter 
allows it to be given additional space. In this case, the 
increased length depends on the amount of storage remaining 
after the text buffer has been allocated. 


Note: Space allocated for buffers is not released until linkage 
editor processing is completed. 
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Table Allocation 


Following buffer allocation, the linkage editor assigns storage 
to its fixed-length and variable-length tables. In initial 
allocation, the linkage editor determines the minimum storage 
required by each table. The size of each table and the number 
of entries in each table are saved in the all-purpose table. 


Storage is then reallocated. The storage in excess of the 
minimum required for all the tables is determined. The excess 
is used to expand proportionately the variable-length tables. 
Then, the size of each table and the number of entries per table 
are calculated. This information and the newly assigned table 
addresses are saved in the all-purpose table. When all linkage 
editor processing is completed, all table space is released. 


INPUT PROCESSING 


The input processing phase comprises modules HENLFINP, HENLFINC, 
SEUnERCG. HEWLFESD, HENLFSYM, HENLFRAT, HEWLFEND, HEWLFIDR, and 


The operations performed during input processing depend on the 
nature of the input; special processing is required for each 
input record type. Each input record is read, using one of two 
read blocks. The first read control block contains the address 
of the SYSLIN buffer, the address of the SYSLIN DCB, and the 
block size and logical record length. The second read control 
block contains the address of the buffer for library records 
Cobject module buffer or load module buffers), the address of 
the library DCB, and the block size and logical record length. 
A pointer is used to indicate which read control block is to be 
used for the input record. Initially, the pointer is set to the 
SYSLIN read control block. 


The type of input processing required is determined by the 
following conditions: 


@ For all object module records whose first column character 
is a blank, control statement scanning is required, provided 
that the record is not encountered "in module." (Control 
statements encountered within a module cause an error 
indication. ) 


° Either object module processing or load module processing 1s 
required, depending on the type of input module. Only 
object modules are read from SYSLIN. Input modules from 
libraries are identified by record format. (Fixed format 
(F) indicates object modules; undefined format (U) indicates 
load modules. ) 


® When an INCLUDE control statement is detected during normal 
processing, “include™ processing is initiated. At 
end-of-input from the specified include library, normal 
processing resumes. If an INCLUDE control statement is 
detected during "include™ processing, "include™ processing 
is reinitiated for the new include library. 


® At end-of-input from SYSLIN, automatic library call 
processing is required if the NCAL option (no automatic 
library calls) was not selected. If the NCAL option was 
selected, input processing is complete. 


e At end-of-input from SYSLIB during automatic library call 
processing, automatic library call processing is 
reinitiated. 


e If a NAME statement, which may indicate a multiple execution 
of the linkage editor, is detected during control statement 
scanning, processing proceeds as if an end-of-input has 
occurred on SYSLIN Cautomatic library call processing is 
performed). 
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6 If an end-of-input occurs on SYSLIN but no valid input was 
received, linkage editor processing is terminated. 


Reading Blocked Input 


The linkage editor can accept blocked card image input from the 
SYSLIN data set and blocked object module records from the 
SYSLIB data set Cor from a user's library). Generally, the 
record format, block size, and logical record length are 
established either when the data set is created, or when they 
are specified on the DD statement for the data set in an 
execution of the linkage editor. If the BLKSIZE field is not 
specified, the linkage editor assumes a block size of 80. The 
logical record length CLRECL) is fixed at 80. 


If the block size specified on primary input exceeds the 
allowable maximum or is not a multiple of the logical record 
length, an error message (IEW0594) is issued and linkage editor 
processing is terminated; if the invalid block size is specified 
on input from a library, the data set is ignored, but processing 
is not terminated. The block size specified by the user is used 
as the read count; if a short block is read, the linkage editor 
determines (via an exit at SYNAD) whether the length of the 
short block is valid (Ca multiple of the logical record length), 
and the number of the logical records it contains. 


If SYSLIN is a concatenation of data sets, the input processor 
reexamines the block size fields whenever a data set boundary is 
crossed to determine whether their values have changed. 


Record Lengths for SYSPRINT 


In determining record lengths for SYSPRINT, the linkage editor 
first checks the block size unless time sharing is in effect. 

If the BLKSIZE 1s not specified by the user, it is set equal to 
121. If the block size exceeds the allowable maximum or is not 
an integral multiple of 121, linkage editor processing is 
terminated and a condition code of 16 is returned. If the block 
size is a multiple of 121, it is not changed and the logical 
record length for output to SYSPRINT is set equal to 121. 


If time sharing is in effect, both the block size and the 
logical record length for SYSPRINT are set equal to 8l. When 
the linkage editor 1s being executed in the time~sharing 
foreground, header messages are printed only once and all 
line-counting functions are ignored. 


Note: If SYSPRINT is a member of a partitioned data set and the 
DSCB is changed (by setting the logical record length or 
changing the block size), it may be impossible to use the 
information in the other members of the PDS. 


Record Lengths for SYSTERM 


The block size and the logical record length for output to 
SYSTERM are set equal to 121 unless time sharing is in effect. 
If time sharing is in effect, the block size and the logical 
record length are set equal to 8] 


Note: If SYSTERM is a member of a partitioned data set and the 
DSCB is changed (by setting the logical record length or 
changing the block size), it may be impossible to use the 
information in the other members of the PDS. 
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When an input record is found to be a control statement (a blank 
in column 1), it is scanned to detect format errors and 
continuation of comments or operands. A vector table is scanned 
to determine the appropriate processor; separate processing is 
required for each type of control statement CINCLUDE, REPLACE, 
LIBRARY, CHANGE, INSERT, OVERLAY, ENTRY, ALIAS, NAME, SETSSI, 
IDENTIFY, HIARCHY, ORDER, PAGE, SETCODE, EXPAND, and MODE). 
"Diagram 8. Control Statement Processing"™ on page 82 illustrates 
general processing of each control statement type. 


The general format for linkage editor control statements is 
shown in Figure 7. The control statement scanner interprets 
symbols enclosed in parentheses as "level 1" symbols; symbols 
not enclosed within parentheses are "level 0.." ENTRY, ALIAS, 
INSERT, HIARCHY, SETSSI, and PAGE control statement operands 
contain only level 0 symbols. CHANGE, IDENTIFY, SETCODE, 
EXPAND, and MODE statement operands always contain both a level 
0 symbol anda level 1 symbol. 
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Figure 7. Control Statement Scanner Operation 





The operands of REPLACE, INCLUDE, OVERLAY, NAME, and ORDER 
control statements contain level 0 symbols, or both level 0 and 
level 1 symbols. LIBRARY statement operands may contain level 
1, or both level 0 and level 1 symbols. The operation to be 
performed depends on the operand format. 


The control statement scanner searches a vector table for the 
operation symbol to determine the associated control statement 
processor. It then analyzes the operands using two work areas, 
“OPD1" and "OPDO", and two pointers, "P1" and "P2". OPDI1 is 
used for level 1 operand symbols; OPDO is for level 0 operand 
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symbols. Pl points to the operand symbol being analyzed; P2 
points to either OPDO or OPD1, depending on the level of the 
operand symbol referred to by Pl. 


An operand symbol referred to by Pl is placed by the READ8 
routine into the work area referred to by P2. Parentheses and 
commas control the switching of pointer P2 between the work 
areas. For example, when a left parenthesis is encountered, P2 
moves to OPD1 because a level 1 operand symbol will follow. 
When a comma, blank, or right parenthesis is detected, the 
PROCENTY routine passes control to the control statement 
processor that was previously found during the search of the 
vector table. 


When an IDENTIFY control statement is read by the control 
statement processor, a switch is set on for the special string 
option utilized by IDENTIFY. When the switch in the control 
statement processor is picked up by the READ8& routine, it sets 
another switch, permitting up to 40 characters to appear in the 
IDENTIFY operand. This allows any character, including embedded 
blanks, to appear between single quotation marks. 


Control Statement Processors 


When the operand symbols have been read into work areas OPDO and 
OPD1, control is passed to the control statement processor at 
the saved entry point. Scanning of the control statement 
resumes when the control statement processor returns control. 
The individual control statement processors are described in the 
following paragraphs. 


CESD 
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Figure 8. INCLUDE Statement Processing for a Sequential Data Set 
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INCLUDE STATEMENT PROCESSOR: The INCLUDE statement processor 
builds a chain in the CESD of items to be included. Each item 
in the chain contains the address of the next item in the chain 
Cin the chain/address field—bytes 9, 10, and 11). The last 
item in the chain contains zeros in this field. 


Chained include items have two kinds of subtypes: “include with 
pointer™ and “include without pointer." In Figure 8, the 
statement INCLUDE M defines M as a sequential data set. The 
INCLUDE statement processor creates an entry for the ddname M in 
the CESD, with the subtype "include without pointer." 


In the statement INCLUDE LIBX (A), A is defined as a member of a 
PDS. The INCLUDE statement processor creates an entry for A in 
the CESD, with the subtype “include with pointer.” The pointer 
is in the chain pointer/chain ID field (bytes 14 and 15); it 
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contains the CESD line number of the ddname LIBX. A single 
ddname, such as LIBX, may be referred to by several pointers. 


Figure 9 describes INCLUDE statement processing with nested 
members. 
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Figure 9. INCLUDE Statement Processing With Nested Members 


e The statement INCLUDE TEMP CA, B, C) indicates that A, B, 
and C are members to be included from library TEMP. 


@ Member B contains the nested statement INCLUDE LIBX CU, V, 
W); this is the last statement processed in member B. 


6 The CESD is shown at the time when the control statement 
scanner has read operand V, but not W. The INCLUDE 
statement processor has created a CESD line for operand V in 
the LIBX include chain. C is currently the last item in the 
TEMP include chain. When the control statement scanner 
reads operand W, the INCLUDE statement processor enters a 
CESD line for W between V and C; this process is distinct 
from the one that actually searches the members U, V, and C 
on the library (see "INCLUDE Processing"™). 


At the time chosen for this example, the data set member B is 
being read; data set member A has been read and therefore is no 
longer in the CESD as a member name, but data set members U, V;, 
and C have not yet been read. 


The chained CESD entries created by the INCLUDE statement 
processor are later processed by the include processor. 
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OVERLAY STATEMENT PROCESSOR: The OVERLAY statement processor 
maintains a record of the current segment number and updates it 
by one each time a new OVERLAY statement is encountered. The 
relationship of segments in an overlay tree structure is kept in 
the segment path table (SEGTA1) (see Figure 10). Entry nin 
SEGTAl contains the number of the segment that precedes the nth 
segment of the overlay tree structure (the next higher segment 
in its path). The OVERLAY statement processor creates a chain 
of overlay items in the CESD and updates SEGTAl. If the level l 
operand (REGION) is detected, the current region number is 
incremented by one, and a zero is entered as the previous 
segment number in SEGTAIL. 


If an OVERLAY statement is encountered that refers to a node 
point higher in the overlay tree structure, all symbols 
identifying node points higher in the path are removed from the 
chain; their CESD lines are marked "null." For example, in 
Figure 10, when the statement OVERLAY A is encountered after 
segment 4, the CESD entry for symbol B is marked null and is no 
longer in the chain. If an OVERLAY B statement was encountered 
at the end of segment 5, a new node point would be established 
for B, and symbol B would again be entered in the CESD. 









All Purpose Table 
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* In this example, card OVERLAY C has just been recd. Name B is 
no longer in the chain, 


Figure 10. Overlay Statement Processing 









LY26-3963-0 © Copyright IBM Corp. 1972,1985 Method of Operation 27 


Contains Restricted Materials of IBM 
Licensed Materials ~— Property of IBM 


HIARCHY STATEMENT PROCESSOR: The HIARCHY routine first 
determines if the hierarchy number is valid. If it is invalid; 
the statement is printed; an error message is written and the 
remainder of the statement is ignored. If the number is valid, 
it is converted to binary and saved for the SCAN routine. 


Processing of the statement continues with the collection of the 
next symbol, up to a comma or a blank. The CESD is searched for 
this symbol; the location in the hierarchy table corresponding 
to this CESD item is set to the hierarchy number specified. 

(The hierarchy table is built during initialization if HIAR was 
specified. The hierarchy table consists of 1 byte per entry in 
a one-to-one correspondence with the number of items allocated 
to the CESD. The address of this table is kept in a fullword in 
the all-purpose table.) 


If the symbol does not appear in the CESD, the symbol is entered 
in an unused entry in the CESD, marked external reference, and 
the hierarchy number is stored in the corresponding entry in the 
hierarchy table. This procedure is repeated for each additional 
symbol in the HIARCHY statement. 


The intermediate output routine uses the hierarchy table to 
place the hierarchy number associated with each CESD item in the 
scatter/translation table. © 


INSERT STATEMENT PROCESSOR: The insert statement processor 
scans the CESD for the symbol indicated in the INSERT statement. 
If the symbol is found, the segment number field is changed to 
the number of the segment that contains the INSERT statement. 

If the symbol is not found in the CESD, a new ER entry in the 
CESD is created. In either case, the CESD entry is marked 
Winsert™ in the subtype field, and the segment number of the 
INSERT statement is placed in the segment number field. 


REPLACE AND CHANGE STATENENT PROCESSORS: The REPLACE and CHANGE 
statement processors build a chain of CESD entries. Each entry 
to be replaced, changed, or deleted is so marked in the subtype 
field. The ESD processor examines the replace/change chain 
before processing any ESD item. Because a REPLACE or CHANGE 
statement applies only to the module that immediately follows it 
in the input, the replace/change chain is removed from the CESD 
at the end of the module. 


When a REPLACE statement or a CHANGE statement operand contains 
two symbols, such as CHANGE A (B), A and B are entered in 
consecutive lines of the CESD. Only the first line of the pair 
(the line for A) contains the address (in the chain address 
field) of the next item in the replace/change chain. 


NAME STATEMENT PROCESSOR: The NAME statement processor places 
an entry in the all-purpose table containing the name under 
which the output load module is to be stowed in the PDS 
directory. If the operand contains the level 1 symbol (R), a 
bit is set to indicate that the module is to be stowed as a 
replacement for a module of the same name. Another bit is set 
to indicate that a NAME statement was encountered; the input 
processor tests this indicator and terminates input operations 
if it is set. If a NAME statement is received from any input 
source other than SYSLIN, the error routine is entered; NAME 
statements are accepted only if they are in the primary input. 


SETSSI STATEMENT PROCESSOR: The SETSSI statement processor 
converts the 8 bytes of hexadecimal information specified ona 
SETSSI statement to a 4G-byte field, and enters it into the 
all-purpose table. During final processing, this information is 
entered into the system status index, a 4-byte extension of the 
user data area in the PDS directory. The index contains 
information describing the status of members in the library and 
is used for maintenance purposes. 


28 MYS/XA Linkage Editor Logic LY26-3963-0 © Copyright IBM Corp. 1972,1985 


Contains Restricted Materials of IBM 
Licensed Materials ~~ Property of IBM 


ORDER AND PAGE STATEMENT PROCESSOR: The ORDER and PAGE 
statement processor builds the ORDER table. First, the CESD is 
searched for a match to the symbol specified in the ORDER or 
PAGE statement. If the symbol is not found in the CESD, the 
symbol is entered into the CESD as a "weak external” reference 
(NX). The ESD identifier of the CESD line is entered into the 
ORDER table. When a matching symbol is found in the CESD, and 
the entry is not a control type ER, the ID of the CESD line is 
entered into the ORDER table. 


The appropriate flags are set in the ORDER. table entry to 
indicate if the specified request is either an ORDER or a PAGE 
statement. The ORDER flags are set when text ordering during 
output processing is requested. The PAGE flags specify that the 
linkage editor is to perform page alignment during address 
assignment. The ORDER flags can be set only when an ORDER 
control statement is present. The PAGE flags can be set in one 
of two ways: (1) if P is specified on an ORDER control statement 
or €2) if the PAGE control statement is present. See Figure ll 
for an example of order and page processing. 
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Figure 11. Order and Page Processing 


Note: In this example, CSECTB must follow CSECTA and CSECTC in 
the order table. Ordering was not specified for CSECTB. 


IDENTIFY STATEMENT PROCESSOR: The IDENTIFY statement processor 
picks up the CSECT name from OPDO, the length of the special 
string SPECSTR extracted by the READ& routine, and the identify 
data placed in SPECSTR by the READS routine. This information 
is placed in storage, and parameters and control are passed to 
the IDR processor HEWLMIDR at the entry point HEWLCIDR. 


ENTRY STATEMENT PROCESSOR: The ENTRY statement processor places 
the symbol specified in an ENTRY statement in the all-purpose 
table. The symbol will override any symbol specified in an END 
statement as the entry point for the module. 


ALIAS STATEMENT PROCESSOR: The ALIAS statement processor 
creates chained CESD entries for a maximum of 16 alias names 
specified in ALIAS statements. During address assignment, these 
entries are used to build the alias table. 
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LIBRARY STATEMENT PROCESSOR: The LIBRARY statement processor 
creates chained CESD entries for the operands specified in 
LIBRARY statements; a chain is created for each distinct 
library. Each chain begins with a library ddname and contains 
all member names specified for the library (see Figure 12). 


A member name specified in a LIBRARY statement can result in one 
of two kinds of ER subtypes: "matched library member" or 
"unmatched library member." If a CESD entry is created for a 
member name specified in an input ER and also specified in a 
LIBRARY statement, it is called a "matched library member.” 
However, if the member name was specified only in a LIBRARY 
statement, the entry subtype is "unmatched library member." 
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(subtype 03). 






@ SAM and MARY were not previously inthe CESD, They cre created as "unmotched 
library member" (subtype 02). 


@ The CESD shown in diogram C results from the CESD shown in diagrem 8 ofter 
reading in an input module containing the ER MARY ond the $D JOE. (Only the 


library chains cre shown). 


@ JOE is removed from the chain in diogrem C, and the chain pointers cre modified. 
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® MARY becomes o "matched" subtype ond will be called by the automatic 
library ecll processor (unless resolved by other input). 


Figure 12. Library Statement Processing 





EXPAND STATEMENT PROCESSOR: The EXPAND statement processor 
accumulates the expansion length specified and, if necessary, 
limits that length to 4095 bytes. If the name specified matches 
the name of a named control section or common section, the 
length of that control section or common section is updated by 
the expansion length in the matching CESD entry. A special 
entry is then made to the text processor to create and save text 
of the expansion length to be added to the control section or 
common section. 
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MODE STATENENT PROCESSOR: The MODE statement processor verifies 


that the valid mode keywords, AMODE and RMODE, are specified and 


that the valid mode specifications are used—24, 31, or ANY for 
AMODE; 24 or ANY for RMODE. Appropriate values are set in the 
all-purpose table to indicate the mode(s) specified. 


SETCODE STATENENT PROCESSOR: The SETCODE statement processor 
accumulates the authorization code specified. A limit of 8 
digits specifying a value of 0 to 255 is imposed. Once 
verified, the authorization code is saved in the all-purpose 
table. 


Object Module Processing 


If input to be read by the linkage editor consists of object 
modules (fixed (F) record format indicates object modules), the 
following operations are performed: 

e Determine record type 

e Set up general registers 

e Perform special event processing 

The record type is determined by examining columns 2 through 4 
of each logical input record. For each record type (SYM, ESD, 
TXT, RLD, IDR, END), special processing is required. | 


The general registers are loaded with input record information 


to be used in the required processing, as described in 


Figure 13. 
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Following is a description of special event processing: 


Load Medule Processing 


When end-of-input is detected, any data still contained in 
the input RLD buffer or the input text buffer is written out 
on SYSUT1, if necessary. 


See the Appendix, "Input Convention and Record Formats." 


If the TEST attribute is selected, the SYM records from the 
object module are blocked 3-to-~-l in the input RLD buffer and 
written out on SYSLMOD. When the first TXT record ina 
module is encountered (Cor, if no text record has been 
encountered when the END record is detected), remaining SYM 
records in the input RLD buffer are written out on SYSLMOD. 


When processing of an ESD record is completed, indicators in 
the all-purpose table are examined to determine if: 


= A control section (SD, PC, or common) was indicated on 
the ESD record 


- The TEST attribute was specified 


If both conditions are met, the ESD record is blocked 3-to-l 
in the input RLD buffer and written out on SYSLMOD. 


If a control statement continuation is expected and an 
object module record is read, an error condition occurs and 
a coded diagnostic message is produced. Normal object 
module processing is then performed on the record. 


If, during object module processing, a record is encountered 
that is not one of the six acceptable types (SYM, ESD, TXT, 
RLD, IDR, or END), an error condition occurs and a 

set albarials message 1s produced. The input record is then 
ignored. 


Load modules included as input to the linkage editor are 
processed in the following manner: 


The input record type 1s determined by an identification 
field (byte 1 of the record), as shown in Figure 14 on 
page 33. Special processing is performed for each record 
type. 


The parameter registers are loaded with input record 
information to be used in the required processing, as 
described in Figure 15 on page 33. 


If the record is not identified as a TXT, CESD, 

IDR, scatter/translation, SYM, or CTL/RLD record, an error 
condition occurs and a diagnostic message 1S printed out. 
The input record is otherwise ignored. 


If the TEST attribute was not specified, all SYM records are 
ignored. 


If an end-of-module indication is found ina CTL or RLD 
record, cleanup functions are performed. 


When a CTL record is detected, the following TXT record is 
immediately read into the input text buffer if it is not to 
be deleted. 


If the TEST attribute was specified and a SYM record is 
received, the record is written out as text translation data 
from the RLD input buffer. 
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Figure 149. Input Record Types-—Load Module 
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The following describes the special processing performed during 
object and load module processing for the ESD, IDR, TXT, RLD, 
and END records. 


Every object module in the input to the linkage editor must 
contain at least one ESD item. An ESD item is created by a 
language translator whenever it finds a symbol that is defined 
for external use. An ESD item is created to define the 
beginning of each control section, common areas, entry point 
names, and external references. Each ESD item has a type 
assigned to it that indicates its function. The ESD types are: 


° Section Definition (SD). Defines the beginning of a named 
control section. 


e Private Code (PC). Defines the beginning of an unnamed. 
control section. 


e Label Definition (LD). Defines a label (symbol) whose 
location is defined relative to the location of the control 
section in which it is contained. An LD type ESD item 
eooeoe the ESD ID of the control section that contains the 

abel. 


® Common (CM). Defines a common area for which a virtual 
storage address is assigned during linkage editor 
processing. The area may be named or unnamed; an unnamed 
area is referred to as a "blank common" area. 


® Pseudo Register (PR). Defines an area external to the 
output module but referred to by it, for which virtual 
storage space is allocated at execution time. The linkage 
editor treats PR symbols as a block that is external to the 
Program. The value assigned to each symbol is a 
displacement within this block. 


® External Reference (CER). Specifies a symbol that is 
referenced but not defined within an input module. 


@ Weak External Reference (WX). Specifies an external 
reference that is not to be resolved by automatic library 
call. A WX entry is processed as an ER entry with a "weak 
call" flag. 


A load module in the input to the linkage editor contains at 
least one CESD record unless the module is marked not editable 
(NE). The CESD record types are the same as for ESD records, 
with the following additions: 


@ Null Type. This indicates that the item is to be ignored in 
any reprocessing of the module by the linkage editor. 


e Label Reference (LR). This defines a label (symbol) within 
a control section. An LR type CESD entry is numbered; it 
contains the ESD ID of the control section entry in the 
ID/length field. An LR may be referenced directly by an RLD 
item in the same module, whereas an LD may not. All LD 
items are changed to LR items during linkage editor . 
processing (LDs are contained only in object modules, never 
in load modules). 


e Private Code (PC) Marked Delete. This is a CESD item 
created only for ENTABs and SEGTABs. PC-delete entries are 
placed in the renumbering table, indicating that associated 
TXT and RLD information is to be deleted. 
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ESD Processing 


The main function of ESD processing is symbol resolution. 
Individual ESDs in the input to the linkage editor are combined 
into a composite ESD, which contains all symbols in the input 
that were not changed, deleted, or replaced. A chained 
replace/change list (produced by the control card scanner) 
specifies which ESD items are to be changed, deleted, or 
replaced. A renumbering table (RNT) is also produced during ESD 
processing; it is used during TXT, RLD, and END processing to 
translate the ESD IDs of the input ESD items to CESD IDs. 
"Diagram 9. ESD Processing™ on page 83 provides a general 
illustration of several types of ESD processing. 


At the beginning of ESD processing, control information from the 
ESD record is saved: the ESD ID of the first ESD item in the 
record (other than an LD); the number of bytes of ESD 
information; and the type field of the first ESD item. 


If the OVLY option has been specified for the output load 
module, the following occur: 


® The current segment number is placed in the ESD, unless the 
entry type is PR CPRs have an alignment value in the segment 
number field). 


® The RMODE for the load module is forced to 24. 


@ If automatic library call processing is being performed, the 
segment number is forced to 1 Call automatically called 
modules are placed in the root segment of the overlay 
structure). 


If the OVLY option has not been specified for the output load 
module: 


e If the current ESD item is from a load module in overlay 
format, the AMODE/RMODE data is forced to 24/24. 


e Otherwise, the content of byte 12 is interpreted as 
AMODE/RMODE data. 


The ESD item is then processed according to its type, in the 
following manner: 


@ If the ESD item is an ER, bytes 10, 11, and 12 are set to 
zero in the input buffer Ceither the object module buffer, 
the SYSLIN buffer, or the first pass RLD input buffer). 
Byte 10 must be cleared because automatic library. call 
processing uses it to indicate whether automatic library 
calls have been processed. Bytes 11 and 12 must be cleared 
because any nonzero data (including blanks) will be entered 
in the delink table if delinking is required for the symbol. 
If the input item is an ER item from an object module, the 
CESD subtype field is also reset to zero to indicate that 
there are no modifiers in the subtype field. 


e If a REPLACE/CHANGE function has been requested for the 
input module, the replace/change chain that was built in the 
CESD by the control statement scanner is examined and the 
appropriate modifications are made. For example, if the 
scanner received the statement CHANGE ACB), the CESD 
contains a line for A, marked as a change statement item in 
the subtype field; the next line contains the symbol B. The 
input ESD item symbol is changed from A to B during ESD 
processing. 


® If the ESD item is a PC, the CESD is not searched because 
each PC entry is treated as a unique entry. The PC is 
Placed in the next available CESD line and is processed in 
the same manner as an SD. 
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e If the ESD item is a null item, the renumber routine is 
entered. (This routine is described under "Nonresolution 
Processing. ”™) 


8 If the ESD item is an LD, it is changed to an LR. The item 
is then processed as an LR. (There are some minor 
differences in processing LDs that have been changed to LRs; 
for this reason, an internal indicator is set when the type 
is changed to LR.) 


e If the ESD item is a PC or SD, the AMODE/RMODE data is 
checked for a valid combination. If an invalid combination 
is found, an error message is issued and the RMODE for the 
output load module is forced to 24 


After the ESD type is determined, the CESD is scanned for a 
matching symbol. If no match is found, nonresolution processing 
is performed. If the input ESD symbol matches a symbol in the 
CESD, resolution processing is performed. Resolution processing 
results in only one CESD entry for each unique input ESD symbol; 
multiple occurrences of the same input ESD symbol are listed in 
ll renumbering table (RNT), with pointers to the single CESD 
entry. 


NONRESOLUTION PROCESSING: If no matching symbol is found in the 
CESD, the input ESD item is processed as described below. 


2D Items: If the input ESD item is an SD (see "Diagram 9. ESD 
Processing" on page 83, area A): 


e The freeline routine selects an empty line in the CESD. The 
line following the current line is chosen unless a previous 
CESD line is marked null. (Whenever possible, null lines 
are used to save space. ) 


8 If automatic library calls are being processed, an indicator 
is set in the type field of the selected CESD line. (Ifa 
module map was requested, this indicator is checked during 
module map processing. If the indicator is set, the control 
section is marked with an asterisk in the module map or 
cross-reference table to indicate that it was obtained from 
a library during automatic library call processing. } 


e If the load module is in overlay structure, then those 
routines brought into the load module via the automatic 
sea call are placed in the root segment of the load 
module 


e A "write™ indicator is set in the all-purpose table to note 
that SDs, PCs, or CMs were encountered in the input record. 
When ESD processing is completed, the write indicator is 
tested. If it is on and the TEST attribute was specified, 
ESD records containing SDs, PCs, or CMs are saved, blocked 
3-to-l in the input RLD buffer, and written out on SYSLMOD. 


e In any input object module, the CESD line number of the 
first SD entry whose length is zero is saved. END 
processing uses this CESD line number to enter the length 
specified on the END card. 


e The enter routine creates a CESD entry for the input ESD 
item; it moves the symbol length, segment number, ID, and 
type into the selected CESD line. In addition, the enter 
routine accumulates the residence mode for the output load 
module. Initially, the residence mode is ANY. As each 
control section (SD or PC) is allocated in the output load 
module, its residence mode is included in the accumulation. 
If all control sections allocated in the output load module 
have a residence mode of ANY, the output load module has a 
residence mode of ANY; if any control section allocated in 
the output load module has a residence mode of 24, the 
output load module has a residence mode of 24. (The 
residence mode accumulated from the ESD data may be 
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overridden by the residence mode specifications in the PARM 
field or the MODE control statement.) 


@ The renumber routine places the line number of the new CESD 
entry into the renumbering table to provide a means of 
translating the input IDs to the new CESD IDs. For example, 
if the input ESD item has a line number CESD ID) of 3, but 
the item is placed into the CESD at line 5, a 5 is placed in 
the third line of the renumbering table. (For each input 
ESD line, except LD lines, there is a corresponding RNT 
line. The RNT contains information for the current module; 
it is set to zero at the end of each input module. ) 


ER Items: If the input ESD item is an ER, it is entered in the 
Siento renumbered as described above; no special processing is 
required. 


WX Items: If the input ESD item is a WX, it is entered in the 
CESD and renumbered as described above; no special processing is 
required. 


CM Items: If the input ESD item is CM (see "Diagram 9. ESD 
Processing™ on page 83, area E), a "common® indicator is set and 
the item is treated as a delete item. If the address that was 
assigned to the CM item by the language translator is not zero, 
it is saved in the delink table for later use. (Two CM items 
with the same identifying symbol may have different assigned 
addresses; therefore, the assigned address in the input must be 
subtracted from all address constants that refer to the CM 
items, so that they are returned to their displacement value 
before relocation.) The CM item is then renumbered and entered 
into the CESD. 


LR Cor LD) Items: If the input ESD item is an LR or LD (see 
"Diagram 9. ESD Processing™ on page 83, area C): 


e When processing an LR, the label routine determines whether 
the SD for the control section has been processed. If the 
SD has not been received, any LRs that refer to that SD are 
chained together in the CESD until the SD is received. (The 
SD might be marked replace; therefore, the LR cannot be 
processed until the SD is received.) When the SD is 
received, all dependent LRs are processed. Each LR ID field 
is renumbered, using the renumbering table, so that it 
refers to the CESD ID of the SD. 


° LDs are not renumbered because they are not referred to by 
RLDs and are not numbered in language translator output. 
The enter routine places them directly in the CESD. If an 
LD is received before the SD to which it belongs, it is 
handled as an LR. 


PR Items: If the input ESD item is a pseudo register, the 
current segment number is not entered in column 12 of the ESD 
item. Column 12 of a PR item contains an alignment value, which 
indicates that the PR must be aligned to a halfword, fullword, 
or doubleword boundary. The PR is then processed by the 
freeline, enter, and renumber routines as described above. 


RESOLUTION PROCESSING: If a matching symbol is found in the 
CESD, the type fields of the input item and the matching CESD 
item are compared and resolution processing is then performed. 
The following conventions are observed during resolution 
processing: : 


® Input PR items may match only PR entries in the CESD. If an 
input PR item matches a non-PR item in the CESD, it is not 
eer ee as a match; the CESD search for a matching PR item 
continues. 


° If the matching CESD item is marked "chained," resolution is 
performed on the item to which it is chained. 


LY26-3963-0 © Copyright IBM Corp. 1972,1985 Method of. Operation 37 


Contains Restricted Materials of IBM 
Licensed Materials =~ Property of IBM 


If the CESD line is marked null, the match is ignored and 
the search continues. 


If the CESD item is an ER produced from a REPLACE, CHANGE, 

OVERLAY, or ALIAS statement, or from the ddname field of an 
INCLUDE or LIBRARY statement, the match is ignored and the 

search continues. 


Matching items are processed in the following manner: 


If the input ESD item is CM, SD, or LR and it matches an ER 
in the CESD, the input type replaces the type indicated in 

the CESD item (see "Diagram 9. ESD Processing" on page 83, 

area B). Nonresolution processing is then performed on the 
input item. 


If the input ESD item is an LR and it matches a CM, SD, or 
LR in the CESD, a "match™ bit is set indicating that a 
double symbol definition is possible. If the SD for the 
control section has been entered in the CESD and is marked 
for deletion, the Label routine deletes the label; if it is 
not marked for deletion, a "double symbol definition" 
message is produced. If the SD for the control section is 
not in the CESD, the LR is chained to the matching LR; when 
the SD is received, the LR is deleted or a double symbol 
definition message is produced, depending on whether or not 
the SD is being deleted. 


If an input PR matches a PR in the CESD ("Diagram 9. ESD 
Processing" on page 83, area D), the greater length and the 
most "constrictive" boundary alignment are placed in the 
CESD entry. CA doubleword alignment is more constrictive 
than fullword alignment; fullword is more constrictive than 
halfword; etc.) The input PR entry is then renumbered to 
the updated PR entry in the CESD. 


If an input SD item matches an SD entry in the CESD, 
automatic replacement of the control section occurs. The 
input SD item is entered in the CESD as a delete type and is 
chained to the matching SD entry. (During second pass 
processing, the assigned address of the control section 
being replaced will be subtracted ("delinked") from the 
addresses of any nonbranch-type address constants that refer 
to the SD-delete entry.) The SD-delete item remains chained 
only while the module is being processed; END processing 
will change the. chained items to null entries (see 
™Delinking Nonbranch-Type Address Constants"). 


If an input SD item matches a CM entry in the CESD, and the 
length of the SD item is greater than or equal to the length 
of the CM item, the length of the SD item is entered in the 
CESD. If the program is in overlay, the common path routine 
scans the segment path table (SEGTA1) to find the segment in 
the overlay structure that is common to both items, and 
places the segment number in the SP entry. The SD item is 
then written over the CM line and renumbered. (This is 
referred to as "automatic promotion of common."™) 


If an input SD or CM item matches an LR in the CESD, a 
"double symbol definition" message is produced, and the SD 
or CM item is entered in the CESD as a delete type and is 
mileage ha the matching LR entry, causing the SD or CM to be 
replaced. 


If the input item is CM, it may be "blank common.” Blank 
common may match a PC item in the CESD because both contain 
blanks in the symbol field. In such a case, the match is 
ignored and the search continues. 


If an input CM item matches a CM item in the CESD ("Diagram 
9. ESD Processing™ on page 83, area F), the greater of the 
two lengths is entered in the CESD. If the module is being 
processed for overlay, the segment number of the segment 
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IDR Processing 


common to both the input item and the CESD item is also 
entered in the CESD item Cautomatic promotion of common). 


6 If an input CM item matches an SD item in the CESD, and the 
length of the SD item is greater than or equal to the length 
of the CM item, the length of the SD item is entered in the 
CESD. The CESD type is not changed. If the module is being 
processed for overlay, the segment number of the segment 
common to both the input item and the CESD item is also 
entered in the CESD item (automatic promotion of common). 


e Whenever an input ER item matches an ER in the CESD, both 
the type and subtype fields are examined; the ER items are 
then resolved in the following manner: 


om If the subtype fields of both ER items are not marked, 
the input item is not entered in the CESD; the matching 
FR remains in the CESD and a pointer to it is placed in 
the renumbering table entry for the input item. 


_ If both items are marked "delete,™ the new ER is entered 
in the CESD and the old item remains there so that they 
can be delinked individually Cin this case, the CESD may 
contain two ER items for the same symbol). Delinking is 
described in "Second Pass Processing." 


- If the input ER item is marked for deletion but the ER 
item in the CESD is not marked delete, the input ER is 
chained to the matching ER in the CESD. The chained ER 
item remains in the CESD until end-of-module is 
detected, so that the delink value can be saved. 


_ If the input ER item is not marked for deletion and the 
ER item in the CESD is marked "delete”™ or "replace," the 
delete bit in the subtype field is cleared (delete is 
changed to replace) and the item is renumbered. If the 
matching ER item in the CESD is marked "no call” or 
"library member,” it is marked "matched" before 
renumbering. 


- If the input ER item is marked in the subtype field but 
is not marked "delete" or "replace," it is assumed to be 
“never call"; if the matching ER item in the CESD is 
"library member,™ the CESD item is removed from the 
chain of library members and the input ER item is 
entered in the CESD and renumbered. 


e If an input WX matches a WX in the CESD, no change is made 
to the CESD. If the matching entry in the CESD is not a WX 
or a control card entry, the input WX is changed to an ER. 


® If an input ESD item that is not a WX matches a WX in the 
CESD, the CESD item is changed to an ER. In all cases, 
processing continues normally. 


The manner in which CSECT identification records CIDR) are 

processed depends on the type of IDR input records or control 

statements being processed. The input records or control 

statements are: 

® Object module END records 

% Load module IDRs 

e IDENTIFY control statements 

An object module END record contains only translation data; 

oneal! load module IDRs may contain four different types of 
ata: 


e HMASPZAP~supplied data 
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e Linkage editor data 
® Translator-supplied data 
e User-supplied data 


Load module IDR processing is dependent upon the type of data 
present in the IDR record. The IDENTIFY control statement 
contains only user-supplied data. 


Before any IDR data processing begins, the type of IDR input is 
determined either by the input processor HEMLFINP or, if the 
data is from the IDENTIFY control statement, by the control 
statement processor HEWHLFSCN. HENLFINP passes control to 
HENLFIDR at the entry point HEWLFIDR. HEWLFSCN passes control 
to HEWLFIDR at the entry point HEWLCIDR. 


Processing Object Module END Records Containing IDR Data 


bihen byte 33 of an object module END record has an EBCDIC 1 in 
it, one IDR item follows in bytes 34 through 52. If an EBCDIC 2 
appears in byte 33, two IDR iatems follow in bytes 34 through 71. 
A blank in byte 33 indicates that the record contains no IDR 
data. IDR data is present only on an object module END record 
if A aba that produced the object module contains IDR 
support. 


The renumbering table is scanned to determine the correct ESD 
identifiers of the CSECTs to which the translator data applies. 
If any of the CSECTs are marked delete in the renumbering table, 
they are not identified in the IDR output. If the input object 
module contains at least one CSECT that is not marked delete, 
the translator data is removed from the END record and placed in 
the IDR translator data table CIDRTRTAB) and the IDR translator 
ID table CIDRTITAB). These two tables contain the ESD 
identifier of the CSECT to which the translator data applies, 
the translator identification, the version and modification 
level of the translator, and the date of translation. 


A comparison is made with the other entries in the IDRTRTAB for 
a duplicate entry. If a duplicate entry is found, the incoming 
data is combined with that of the previous entry to avoid 
repetition of data. 


Processing Load Module IDRs 


The subtype of the load module IDR is scanned for the type of 
IDR data. If the subtype is 02, the data is from the linkage 
editor; these records are ignored by IDR input processing. When 
the input data is from HMASPZAP Csubtype 01), bits 2 through 7 
of the flags and count field are scanned to determine the number 
of HMASPZAP entries in the record (from 1 to 19 entries are 
possible). 


The entry in the renumbering table corresponding to the ESD 
identifier of the CSECT processed by HMASPZAP is examined. If 
the entry in the renumbering table is marked delete, then the 
IDR data associated with that CSECT is deleted. However, the 
data that is not deleted is placed at the end of the IDR 
HMASPZAP data table CIDRZPTAB). IDRZPTAB contains the ESD 
identifier of the CSECT processed by HMASPZAP, the date of the 
HMASPZAP processing, the data specified during HMASPZAP 
processing (this may be a PTF number or up to 8 bytes of 
variable user data specified on an HMASPZAP control statement). 
If the IDRZPTAB overflows, an error message is written and 
processing is terminated. 


When the input data is translator-supplied data (subtype 04), 
the renumbering table entry corresponding to each ESD identifier 
in the string preceding a translator description is examined. 
If the entry is marked delete, the corresponding ESD identifier 
is deleted from the string; otherwise, the input ESD identifier 


40 MVS/XA Linkage Editor Logic LY26-3963-0 © Copyright IBM Corp. 1972,1985 


Contains Restricted 


Materials of IBM 


Licensed Materials ~~ Property of IBM 


Processing IDENTIFY 


TXT Processing 


is replaced by the renumbered identifier. If at least one ESD 
identifier remains on the string, a check is made among the 
table entries in the IDR translator data table CIDRTRTAB) to see 
whether an identical description has already been entered into 
IDRTRTAB. If an identical description does exist in IDRTRTAB, 
the CSECTs associated with the incoming translator description 
are combined with the existing translator data item to form a 
Single table entry in order to avoid needless repetition of 
data. If it does not exist, a new entry is added for the input 
data. 


When the input data is user data (subtype 08), the renumbering 
table entry corresponding to the ESD identifier of each input 
user data item is examined. If it is marked delete, the user 
data is ignored. If not, the input ESD identifier is replaced 
by the renumbered identifier and the user data is entered at the 
end of the IDR user data table (CIDRUDTAB). The IDRUDTAB entries 
contain the ESD identifier of the CSECT to which the user data 
applies, the date the data was supplied to the module via the 
linkage editor IDENTIFY function, the number of characters in 
the user data field, and the user data. | 


In the case of input load module IDRs containing translator or 
user-supplied data, an individual data item may span more than 
one record. When this occurs, the incomplete portion of the 
item is saved in either IDRTRTAB or IDRUDTAB. The item is 
processed after the next input record has been read, and the 
continued portion of the item 1s combined with the saved portion 
to form a complete data item. 


Control Statement Data 


The control statement processor, HEWLFSCN, passes control to the 
IDR processor at the entry point, HENLCIDR. The CESD is 
searched for an SD type entry matching the CSECT name to be 
identified. If the name is not an SD, an error is logged and 
processing is terminated. If the CESD line is an SD marked 
delete, the data is ignored. If the CESD line is an SD not 
marked delete, the ESD identifier of the matched SD name is 
saved. A check 1S made to see whether there was any 
user-supplied data previously associated with the CSECT. If 
there was, the old data is replaced with the new incoming data. 
If no earlier data exists, the incoming data is added to the end 
of the table IDRUDTAB. 


The manner in which TXT records are processed depends on whether 
they are part of either a load module or an object module, or 
are added using the EXPAND control statement. A load module 
contains records ina specified order. However, in an object 
module, the records may not be in the proper sequence because 
the language translator may have created them out of order 
CEXPAND data is always identified as out of order text). (The 
restrictions on linkage editor input are described in Appendix, 
"Input Conventions and Record Formats.™) "Diagram 10. Processing 
Objyect Module Text™ on page 84 and "Diagram 11. Processing Load 
Module Text Records®™ on page 85 illustrate processing of TXT 
records from object and load modules, respectively. 


Before any address constants can be relocated within a control 
section of an object module, all TXT records must be placed in 
the proper order. This is done in the input text buffer 
CTXTBFBEG), which is variable in length, allowing grouping of 
data within the buffer. 


Each "multiplicity™ of text is assigned a number as it is moved 
Cor read) into TXTBFBEG. A multiplicity is a portion of text 
equal in length to the maximum size of a SYSLMQD output record. 
Within each control section, multiplicity numbers are assigned 
consecutively, starting at 0 
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Text records from object modules contain both text data and the 
control information needed for processing. Text records from 
load modules contain only text, so the associated control record 
must also be examined to obtain the required control 
information. During object module processing, control 
information is placed in registers; this information allows the 
object module text to be moved from the object module buffer 
into TXTBFBEG. For load module text, the assigned address of 
the first byte of text and a pointer to the ID-length list Cin 
the control record) is determined during load module processing. 
eeeaee ene allows the text record to be read directly into 


Processing Object Module Text 


When text is received from an object module, the text record ID 
is renumbered using the renumbering table, so that it refers to 
the CESD entry for the control section that contains the text. 
The size of the control section is obtained from the CESD, and a 
test is made to determine if the whole control section or a 
multiplicity (whichever is smaller) will fit into the space 
available in TXTBFBEG. If the control section length was not 
specified in the CESD entry, only text for the current ID is 
accepted; see "No-~length Control Section" below. 


If there is sufficient space in TXTBFBEG to accommodate the 
tabletext I/0 table control section or multiplicity, the text is 
moved into the buffer and an entry (containing the ID and 
multiplicity number of the text) is made in the text I/0 table. 
A corresponding entry containing the location of the 
multiplicity and the length of the text is made in the text note 
list. The text note list entry also contains a displacement 
field. When text is in order, or on the first occurrence of 
text for a multiplicity, the displacement field is set to 0; for 
out-of-order text, the displacement field contains the 
displacement from the beginning of the multiplicity of the first 
byte of contiguous text. 


If the SYSUT1 record size is smaller than the multiplicity size, 
each multiplicity is divided into pieces, each piece having a 
length equal to the SYSUT1 record size. New text I/0 table and 
text note list entries are made: for each piece; the displacement 
field will contain the displacement of each piece from the 
beginning of the multiplicity. 


NO-LENGTH CONTROL SECTION: When text is received for a 
no-length control section (a control section for which no length 
is specified in its CESD item), space for one multiplicity is 
allocated in TXTBFBEG. Entries are made in the text I/0 table 
and the text note list for the multiplicity, and the text is 
moved into TXTBFBEG. This procedure is repeated for each 
subsequent multiplicity of text for the no-length control 
section. If TXTBFBEG becomes full, its contents are written on 
SYSUT1 as described in "Writing Text on SYSUT1." When the length 
is received, it is entered in the text note list. 


PROCESSING OUT-OF-ORDER TEXT: A load module contains records in 
a definite order. However, records in an object module may not 
be in the proper sequence because the language translator may 
have created them out of order (records resulting from the 
EXPAND control statement are marked out of order). Such records 
may contain discontinuities in addresses (because of a reorigin 
or a disjointed control section), or they may not be contiguous 
(that is, text of a given ID and multiplicity may be 
interspersed with text of other IDs or multiplicities). Records 
of contiguous text must be built on SYSUT1, so that during 
second pass processing the text can be placed into its proper 
position, within its ID and multiplicity, in the second pass 
text buffer. 


The first occurrence of a given ID and multiplicity is read into 


the input text buffer as it is received. Discontinuities and 
noncontiguous text are of no consequence at the first occurrence 
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of an ID and multiplicity. However, once text of a given ID and 
multiplicity has been written out on SYSUT1, any subsequent text 
of that ID and multiplicity must be contiguous to be written out 
on SYSUT1] within each text record. 


Text of a previously written ID and multiplicity is read into 
the input text buffer until a discontinuity, or text of a 
different ID or multiplicity, is encountered. The contiguous 
text in the buffer is then written out on SYSUT1. The 
discontinuous Cor noncontiguous) text is then placed in the 
buffer. If this text represents the first occurrence of an ID 
and multiplicity, the buffer is loaded without regard for 
discontinuities or noncontiguous text. If the text belongs to a 
previously written ID and multiplicity, the text processor will 
rho Araheg only continuous text of that ID and multiplicity in 
e buffer. 


A record that contains noncontiguous text is called a loose 
record; a record that contains contiguous text is called dense. 
The text note list entry for a dense record usually has a 
nonzero value in the displacement field. When the text is read 
back from SYSUT1 into the second pass text buffer during second 
Pass processing, this displacement is used to place the text in 
its proper position within its ID and multiplicity. 


Processing Load Module Text 


Because text records from load modules are ordered and 
well-defined, they require little further processing by the text 
processor. The information in the ID-length list Cin the 
control record) 1s scanned, and each ID 1s renumbered and 
checked to determine whether it is to be deleted. If all IDs 
are to be deleted, the record is ignored and control is returned 
to the input processor. 


When an ID that is to be processed is found, the text record 
containing the ID must be read into TXTBFBEG. The text record 
length is obtained from the associated control record and 
compared against the free space available in TXTBFBEG. If 
sufficient space is available, the text record is read into the 
buffer; otherwise, the contents of the buffer are written on 
SYSUT1 to ensure sufficient space, and the record is read. 


Text is processed in the buffer in the order specified by the 
ID-length list. IDs that are to be deleted are overlaid by IDs 
that are to be processed. The text is divided into 
multiplicities, and entries are made in the text I/0 table and 
the text note list. When all text identified by the ID-length 
list is processed, text processing is completed. 


Writing Text on SYSUTI1 


When no more control sections can be accommodated in TXTBFBEG, 
the contents of the buffer must be written on the intermediate 
data set (SYSUT1). The text I/0 table is scanned to determine 
the order in which control sections are to be written. The 
length of the first control section (that is, corresponding to 
the first text 1/0 table entry) is obtained from its 
corresponding ESD ID; if the length is less than the size of the 
SYSUT1 record, the text I/0 table entry for the control section 
is marked "written." Each subsequent control section is 
similarly processed, and its length added to the sum of the 
lengths of previously processed control sections. 


When the sum of control section lengths reach the limit of a 
SYSUT1 record, the entire group of control sections is written 
on SYSUT1. The relative track address (TTR) is placed in the 
text note list entry corresponding to the last text I/0 table 
entry that was processed. 


When a single control section is larger than a SYSUT] record, 
the multiplicities of the control section are grouped up to the 
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limit of the SYSUT] record size, and written.® When control 
sections or multiplicities are grouped on SYSUT1, the 
multiplicities must be in ascending, consecutive order. If the 
overlay attribute has been specified, no grouped control 
sections are permitted on SYSUT1l. 


Note: Each time an entry is made in the text note list during 
text processing, a check is made to determine whether the list 
is oir If it is full, an error message CIEW0364) will be 
issued. . 


If neither TXTBFBEG nor the text note list becomes full during 
text processing, no text is written on SYSUT1. The text is 


retained in the buffer, and single pass processing is in effect 
for text records. 


RLD Processing 
RLD processing basically consists of: 


e Updating each set of relocation and position pointers (R and 
P Pointers) 


e Processing each flag and address (FA) in the input item 
until the end of the record or the next item with an R and P 
pointer is detected 


RLD records from object modules and load modules are processed 
in the same manner. 


RLD information is grouped in the RLD buffer by P pointer. Each 
P pointer of an input RLD record refers to the ESD entry in the 
input module for the control section that contains the address 
constant. Each time a new P pointer Cone referring to a 
different ESD ID) is detected, an entry is made in the RLD note 
list for the RLD set (a set being an unbroken sequence of RLD 
items having the same P pointer). The RLD note list entry 
contains the following information for each set: 


e The renumbered P pointer to which these RLDs refer. 
* The lowest multiplicity of text to which these RLDs refer. 
® The number of bytes of RLDs. 


@ The storage address of the first byte of RLD data if all 
RLDs remain in virtual storage. If RLDs are written on 
SYSUT1, this field contains the accumulated byte count for 
intermediate chains or the TTR of the record on SYSUT1. 


All adjacent RLD items containing the same P pointer are 
referred to by only one RLD note list entry. Adjacent RLD items 
containing the same R and P pointers are chained, with the R and 
P pointers appearing only once, at the beginning of the chain. 
The remaining RLDs in the chain are compressed by setting the 
flag indicating continuation, and discarding the 4 bytes — 
containing the R and P pointers. 


Each R pointer of an input RLD record refers to the ESD entry in 
the input module upon whose value the address constant depends. 
The R and P pointers are updated using the renumbering table. 
Before renumbering, the R and P pointers refer to ESD entries of 
the input module that contains the RLD items. The pointers are 
‘renumbered so that they point to the proper entries in the CESD 
being created for the output load module. If the R pointer 
refers to a deleted ESD entry, delinking may be performed. If 
the assigned address of the symbol referred to by the address 
constant is zero, the address constant is not delinked. (Normal 


6 If the SYSUT1 record size is smaller than the SYSLMOD record 
size, no grouping is permitted. 
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relocation is performed.) When delinking is necessary, an entry 
is placed in the delink table (a function of ESD processing). 
The delink table entry contains the address (delink value) of 
the symbol being deleted, and the CESD entry number of the 
identically named symbol that is to replace the deleted symbol. 


The ID of the delink table entry for the deleted symbol is saved 
in the renumbering table, and a "delink value saved" indicator 
is set. The ID of the identically named symbol and the ID of 
the new delink table entry are saved because they are later used 
to complete the delinking operation. The R pointer of the RLD 
item must be modified to refer to the delink table entry for the 
deleted symbol, but the original R pointer is needed to process 
any V-type address constants referred to in the RDL item. 
(V-type address constants do not require delinking, but may be 
in a FA string with A-type address constants that do require 
delinking.) Therefore, the R pointer is not modified until the 
string of flag-address (CFA) fields following the R and P. 
pointers has been processed as described below. At that time, 
if the module is to be structured for overlay and it contains 
V-type address constants that refer to the deleted symbol, the 
ae of the identically named symbol is inserted into the calls 
ist. 


Each FA field of the RLD record is processed as follows: 
e The high-order bit of the flag field is set to zero. 


& If the address constant is an A-type, the renumbering table 
entry referred to by the R pointer is checked to determine 
whether it is marked as a PR type. If it is a PR, the RLD 
flag field is also marked PR (because second pass processing 
must handle PRs in a special manner). If the renumbering 
table entry is not an ER or marked delete, the RLD flag 
field is marked for relative relocation. This indicates to 
second pass processing that the difference between the 
origin of the control section in the input and the origin 
assigned by the linkage editor is to be used as a relocation 
factor for the value of the address constant. If the RNT 
entry is an ER or marked delete, the RLD flag field is not 
marked. This indicates to second pass processing that the 
address constant is to be relocated by absolute relocation; 
second pass processing uses the linkage editor assigned 
address of the symbol in the output module as a relocation 
factor for the value of the address constant. (This 
procedure is described under "Second Pass Processing.™) 


e If the address constant is a 4-byte V- type C"branch- type") 
and the program is in overlay, an entry is placed in the 
calls list, provided that the address constant refers across 
control sections (R not equal to P). The calls list is used 
during address assignment processing to determine which 
segments require ENTABs, and the number of entries each 
ENTAB must contain. | . . 


@ For both A-type and V-type address constants, the text 
multiplicity of the address field is determined and is saved 
in the RLD note list if it is lower than any previous 
multiplicity in the RLD record. If two pass processing is 
in effect, the RLD note list is used during second pass 
processing to read back RLD data from SYSUT1 Ceach RLD note 
list entry contains the relative track location (TTR) of an 
RLD record on SYSUT1). The second pass processor uses the 
multiplicity field of the RLD note list entry to determine 
whether the associated RLD record should be read back from 
SYSUT1L for a given multiplicity of text. 


@ When the last FA field in the string has been processed, all 
items in the string have been checked to determine whether 
they require delinking. If any A-type address constants in 
the string required delinking, the R pointer for the string 
1s modified to refer to the associated delink table entry. 
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Figure 16 shows the actions performed during RLD processing for 
each input flag format, and the format of the flags after RLD 


processing. 


(The “output™ column shows the flag formats that 


are passed as input to the Relocation routine of second pass 
After all FA fields have 


processing; 
been processed, 


see Figure 27 on page 68.) 


the intermediate data set (SYSUT1). 
with a maximum length less than or equal to the size of a SYSUT1 





record, so the entire buffer may always be written. 


the next RLD record is processed. 


If the RLD buffer becomes full, 


its contents must be written on 
The RLD buffer is allocated 


As many 


consecutive RLD sets as possible are grouped ina SYSUT1 record. 


Action Performed 


Not PR, 
ER, WX; 
CM, or 
delete 


ER ¢€*02° 
in renum- 
bering 
table) 


Marked for relative 


Marked for absolute 


Marked for absolute 
if assigned address 
item is zero 


Delete or 
CM (*05*) 


PR €'06') 
value) 


Delete or 
CM 


assigned address of 
1s not zero 


Type is 
not 
checked 


relocation 


relocation 


relocation 
of input 


Marked as PR (displacement 


Marked "“delink value saved" if 


input item 


RLD is marked branch-type 


Marked "delink value saved and 
other FA items in string exist 
that are nonbranch-type"™ and 


are being delinked 
Pseudo None. 
Register 
Type l 


Type is 
not 
checked 


length) 


RLD Flag Field Processing 


Notes to Figure 16: 


Remains as a PR 
(displacement value) 


Marked as PR (cumulative 


LOOOLIST 


OOOOLIST 


OOOOLIST 


OOLOLIST 


High-order 
bit of P 
pointer 


OOOILIST 


High-order 


bit of P 


pointer. 


OOLOLIST 


OOLILIST 





Relative 


Absolute 


Absolute 


Pseudo 
Register 
Type l 


Delink 


Branch 


Pseudo 
Register 
Type l 


Pseudo 
Register 
Type 2 


1 Refer to "RLD Input Record (Card Image)" and "Relocation 


Dictionary Record CLoad Module)" in Appendix, 
Conventions and Record Formats.” 


é Internal types processed during second pass. 
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The RLD note list entry for each RLD set in the group contains a 
"osrouped" indicator; the note list entry for the last RLD set in 
the group also contains the relative track address (TTR) of the 
group. 


RLD sets whose lengths exceed that of a SYSUT1 record Crequiring 
more than one output record) are not grouped. RLD note list 
entries for RLD sets that are not grouped contain the relative 
track location (CTTR) of the SYSUTI1 record and a "nongrouped"® 
indicator. 


Each time an entry is made in the RLD note list, a check is made 
to determine whether the list is full. If it is full, error 
message IEW0364 will be issued. 


Note: If neither the RLD buffer nor the RLD note list becomes 
full during RLD processing, no RLDs are written on SYSUT1. The 
RLD information is retained in the RLD buffer, and single pass 
processing is in effect for RLDs. 


END Processing 


When an END record or the end of an input load module is 
detected, END processing is required. The functions of END 
processing include: 


e Resetting tables (such as the renumbering table) that were 
involved in the processing of the input module 7 


e Processing entry point information 


e Deleting any CESD lines marked CHAIN or DELETE, and keeping 
track of deleted lines 


@ Entering in the CESD the length of a control section for 
which no length was specified in the ESD item (Cif the length 
1s contained on the END record) 


e Setting flags in the ORDER table for each entry matched by 
an entry in the CESD, and resetting the flag for formerly 
matched entries 

e Placing the data from END records in object modules created 


by a translator that supports IDR into the IDR translator ID 
and data tables, IDRTRTAB and IDRTITAB 


Include Processing 
Include processing is required when: 
@ The control statement scanner has detected an INCLUDE 
statement and the INCLUDE statement processor has built an 


include chain 


® End-of-input has been detected, and the "more includes" 
indicator in the all-purpose table CAPT) is on 


Include processing consists of preparatory functions COPEN, 
BLDL, FIND) required before the module to be included can be 
read. These functions include: 

® An input pointer to the library read block is set. 


e The SYSLIB DCB is closed Cunless it is open for a 
partitioned data set currently being used). 


e Each entry in the include chain is examined sequentially. 
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SEQUENTIAL DATA SETS: If an include chain entry specifies a 
sequential data set, the data set organization field of the DCB 
is changed from partitioned to physical sequential, and the 
peal a is updated. The DCB is then opened, and the module 
is read in. 


PARTITIONED DATA SETS: If an include chain entry specifies a 
member of a partitioned data set the member name is entered into 
the BLDL list, and the next entry is examined. If the next 
entry specifies a different data set name, the partitioned data 
set 1s opened and a BLDL macro instruction is executed for the 
Single member name. 


If the next entry specifies another member of the s 

partitioned data set, the member name is added to the “ BLDL list 
and the next entry in the include chain is examined. Member 
names are added to the BLDL list until a different data set name 
is encountered, the BLDL list becomes full, or the end of the 
include chain is reached. Because the BLDL list must be in 
collating sequence, each member name is inserted into its proper 
position, moving other entries as necessary. Because included 
modules must be read in the order in which they appear in the 
INCLUDE statement (without regard to the collating sequence), a 
separate table indicating the order of processing BLDL list 
entries is maintained. 


When the BLDL list is completed, the partitioned data set is 
opened, and the record format field CRECFM) in the DCB is tested 
to determine whether the included modules are load modules 
Cundefined format) or object modules (fixed format). If they 
are load modules, the "load module™ indicator is set in the APT. 
This indicator is tested when each module is read in. A BLDL 
macro instruction is then executed for the member names in the 
list. The list is then examined in the order specified in the 
INCLUDE statement to obtain the attributes of each included 
module Cif it is a load module); the attributes of the output 
load module may be "downgraded" accordingly in the APT. 


If the BLDL macro instruction was successful for a particular 
member, the member is read in. The FIND macro instruction and 
the directory entry obtained from BLDL are used to set a pointer 
in the DCB to the first record of the member. If the BLDL was 
not ric for a particular member, a diagnostic message is 
printe 


The INCLUDE processor checks the PDS directory information 
returned by BLDL for an included load module to igre psd 
whether the load module is in overlay format. If it is, 
indicator is set in the all-purpose table, so that the ESD. 
processor can interpret byte 12 of each ESD item as a segment 
number rather than as AMODE/RMODE data. 


An example of INCLUDE processing is given in Figure 17 on 

page 49. The input pointer is set to the address of the library 
read block. The address of the current include item is 
contained in the APT 


Assuming that no includes have yet been processed, A will be the 
first item examined. The subtype 'DO" indicates that A is a 
member of a partitioned data set, so A will be entered into the 
BLDL list. The pointer 000D refers to the data set DATASETX. 

The next item in the include chain, B, is also a member of 
DATASETX, so it is added to the BLDL list. The next item in the 
chain, M, is a sequential data set (subtype C0), so the BLDL 
list is completed with two entries (A and B). Assuming that 
DATASETX is not currently open and the SYSLIB DCB is not opened 
for another data set, the SYSLIB DCB is opened for DATASETX. 
(The RECFM field of the data set DSCB is merged into the DCB.) 
Assuming that the RECFM field indicates undefined (U) format, a 
load module indicator is set in the APT, and a pointer to the 
load module buffer is placed in the library read block. The 
attributes of A and B are obtained using the BLDL macro 
instruction, and the attributes previously specified are updated 
accordingly. (The attributes of the output load module may be 


48 MVS/XA Linkage Editor Logic LY26-3963-0 ©.Copyright IBM Corp. 1972,1985. 


Contains Restricted Materials of IBM 
Licensed Materials — Property of IBM 


downgraded as a result.) A pointer in the DCB is then set to 
the first record of member A, using the FIND macro instruction, 
and the “include initiated” indicator is set in the APT. 





INCLUDE DATASETX 
(A,B,C),M 


Register 2 All Purpose Table 03 
"MORE INCLUDES" INDR 












CRRTINCL 


INCBRKPT | 


Input Pointer OE 





Library Read 





SY SLIN 
Read Block 


SYSLIB OC8 
RECFM 


DONAME 







9400 





SYSLIN DCB 
7768 RECFM 


es) 
967C SY SLIN 


BLKSIZE 


BLKSIZE 





Figure 17. Include Processing 


Member A is read using the input pointer and library read block. 
Module A is then processed. When the end of module A is 
reached, item A is deleted from the chain and the CESD line is 
marked null. Member B is then read and processed. 


When the end of module B is reached, item B is deleted from the 
chain, the CESD line is marked null, and the remainder of the 
chain is processed. 

Automatic Library Call Processing 


Automatic library call processing is required: 


e At the end of SYSLIN input when unresolved ERs still exist 
and the NCAL option was not specified 


® When a NAME statement has been detected (provided that the 


NCAL option was not specified and no more entries in the 
include chain are to be processed) 
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Automatic library call processing consists of two series of CESD 
scans. The first series of scans operates on unresolved ERs 
specified on LIBRARY statements. It finds the first ddname that 
contains a pointer in the chain pointer field (bytes 14 and 15). 
Such an entry is the first item in a chain of members associated 
with this ddname; there is a distinct chain for each ddname that 
was specified on a LIBRARY statement. Chained member names for 
a particular ddname are entered into a BLDL list, which is 
processed as previously described under "INCLUDE Processing." 


The scan of the CESD continues until all ddname chains have been 
processed. A second scan of the CESD then searches for ERs not 
specified on LIBRARY statements and attempts to resolve them by 
calling members of the same name from SYSLIB. 


An example of automatic library call processing is given in 
Figure 18 on page 51. Diagram A shows two library chains that 
were built in the CESD by the library statement processor. In 
Figure 17 on page 49, Diagram B, an SD item for JOE has been 
entered in the CESD, resolving the reference to JOE. (CJOE was 
removed from the chain by ESD processing, and the LIB1 chain ID 
now points to the line containing TOM.) Automatic library call 
processing operates on the library chains, as modified by ESD. 
processing (Diagram B). 


In the first series of scans, the CESD is searched for a ddname 
Ctype 02, subtype BO) with a chain pointer. The ddname item 
LIB] is found; its chain ID points to TOM. Because TOM is 
unmatched (subtype 02), it is not called and because TOM is the 
last item in the chain (0 in the chain ID field), the scan is 
resumed for another ddname with a chain pointer. LIB2 is found; 
its chain ID points to SAM. No call is issued for SAM, because 
it is unmatched. The chain ID of SAM points to PETE, which is 
matched Cindicating that PETE is an external reference, and not 
just an operand of a LIBRARY statement). PETE is entered in the 
BLDL list; because PETE is the last item in the chain, the list 
is completed with one entry. 


LIB2 is opened and the BLDL macro instruction is used to obtain 
the attributes of PETE (the attributes of PETE are not obtained 
if the format is fixed (F)). A "BLDL attempted" indicator is 
set for the CESD entry for PETE, so that no other search for 
PETE will be made in the event of an unsuccessful BLDL, or 
nonresolution of the ER for PETE by the member PETE. The FIND 
macro instruction is used to set a pointer in the SYSLIB DCB to 
the member PETE. PETE is then read in. 


When processing for PETE is completed, the scan for ddnames 
resumes at the beginning of the CESD rather than at the CESD 
line where the scan was interrupted, because additional ddname 
items may have been entered at any available line in the CESD. 
(Object modules with additional LIBRARY statements may have been 
read in.) When the last line of the CESD is reached, the second 
series of scans is begun. 


7 SYSLIB is the standard library whenever the linkage editor 
is executed as a job step. If another program links to the 
linkage editor, the ddname of the standard library is passed 
in a parameter list. 
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Figure 18. Automatic Library Call Processing 


During the second series of scans, the CEDS is searched for 
Tunmarked™ external references (type 02, subtype 00). These are 
ER items not specified on LIBRARY statements. In Diagram B, the 
scan finds SIMPLE. Assuming that SYSLIB is the ddname for the 
standard library, SIMPLE is called from SYSLIB in the same way 
that PETE was called from LIB2. Every time automatic library 
call processing is’ resumed after a module is read, the second 
series of scans resumes at the beginning of the CESD (because ER 
items from a library member may have been entered in any 
available CESD line). 


When the second series of scans is finished, input processing is 
complete. 


INTERMEDIATE PROCESSING 


ADDRESS ASSIGNMENT 


The intermediate processing comprises modules HEWLFADA, 
HEWLFOUT, HEWLFENS, HEWLFENT, and Coptionally) HEWLFMAP. 


When all input processing is completed, the second phase of the 
linkage editor Cintermediate processing) begins operation. The 
two major functions of the second phase are address assignment 
and intermediate output. 


‘At the conclusion of input processing, address assignment 
processing is required (see "Diagram 13. Address Assignment®™ on 
page 87). Address assignment includes the following operations: 


° Deletes CESD entries for ER items marked included, called, 
ddname, or overlay in the subtype field. These lines are 
marked null and are deleted if the module is processed again 
in a subsequent execution of the linkage editor. 
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@ Computes, for programs in overlay, the size of SEGTAB,? 
enters the size in the all-purpose table, and places a 
private code delete entry for the SEGTAB in the CESD. The 
PC-delete entry is deleted from the module if it is 
processed again by the linkage editor (see "Diagram 13. 
Address Assignment™ on page 87, area A). 


® Determines whether the first text record of a load module is 
not assigned to address 0. If it is not assigned to address 
0, a private code delete entry of 1 byte is created in the 
CESD. The PC-delete entry is deleted from the module if the 
module is later reprocessed by the linkage editor. 


e Enters segment numbers for label references in the CESD. If 
the program is in an overlay structure, the calls list 
(built during RLD processing) is also scanned, and pointers 
from one chain of calls to the next chain are arene? Carea 
B); the number of ENTAB bytes? for each segment i 
determined; and a PC-delete entry is placed in the ~ CESD for 
each ENTAB (see "ENTAB Size Determination”). 


e Assigns temporary linked addresses to SD, PC, and CM entries 
in the CESD Carea C). SDs and CMs that have entries in the 
ORDER table are addressed first in the order of their 
appearance in the table. The remaining control sections are 
then assigned addresses to the SDs, PCs, and CMs that have 
no entries either in the ORDER table or the text I/0 table. 
To avoid assigning addresses to any SD or CM more than once, 
a "processed" bit (bit 4 of the 'type"® byte in the CESD) is 
set in each CESD entry when it is first processed. The bit 
is reset to zero in the final scan of the CESD. ? 


e Considers each segment to be at zero origin. The temporary 
starting address of each control section is computed with 
consideration for its location in the segment relative to 
the zero origin (plus any adjustments for boundary 
alignment). These addresses are temporary because the 
starting addresses of the segments must later be relocated 
with respect to their positions in the overlay tree. If the 
program is not in overlay (consists of a single segment), 
the addresses are final because no further relocation by 
address assignment is necessary. 


e Performs page alignment while assigning temporary linked 
addresses if the program is not in overlay. The ORDER table 
is searched for a match of the CESD ID of the SD or CM being 
processed. When a match is found, and page alignment is 
specified, the assigned address is forced to a 4K-byte 
boundary. If the ALIGN2 option is taken, the address is 
forced to a 2K-byte boundary. 


e Computes the temporary relocation constant for each control 
section (the difference between the temporary linked address 
and the assigned address in the relocation constant table 
CRCT) Carea DJ. If the program is not in overlay, these are 
pie relocation constants (relative relocation 

actors). 


e Accumulates the length of each segment in the leftmost 3 
bytes of an entry in the segment length table (SEGLGTH). 


The boundary alignment factor of the first control section 
in the segment is placed in the fourth byte of the entry. 


S SEGTAB size = 24 + (4 x number of segments). 


9 ENTAB size = 12 + €12 x number of unique downward calls per 
segment). 
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Determines the address of each PR entry in the CESD, using 
the total length of all PRs previously encountered plus the 
boundary alignment factor. This address is placed in the 
CESD entry for the PR. The length of this PR is then added 
to the cumulative PR length. 


Processes the SEGLGTH table (if the program is in overlay) 
to determine the starting address of each segment relative 
to the beginning of the program (area E). SEGTAl] is. checked 
to find the proper location of each segment in the tree. 
SEGLGTH at this time contains the length of each segment. 

To determine the starting address of a segment, the length 
of all previous segments in the same path are added, 
together with any adjustments for boundary alignment. 
(Boundary alignment adjustment is determined by the last 3 
bits of the address of the first control section ina 
segment.) This sum, minus the boundary alignment factor for 
the segment, is the segment relocation constant (SRC). The 
SRC is then placed in the rightmost 3 bytes of the SEGLGTH 
table. The sum of the SRC, the boundary alignment factor, 
and the segment length is placed in the leftmost 3 bytes of 
the SEGLGTH table entry for the segment. It is the length 
of the path of the segment Cincluding the segment itself). 
At the completion of this process, the entry in SEGLGTH for 
each segment contains the cumulative length of its path; the 
longest of these lengths is the program length. 


Performs a second scan of the CESD if the program is in an 
overlay structure. The segment relocation constant in the 
SEGLGTH table is added to the temporary linked address in 

the CESD entry for the control section; this sum is the 


final linked address. The SRC is also added to the 


temporary relocation constant table; this sum is the final 


relocation constant for the control section. 


Assigns final linked addresses in ascending order of 
segments if page alignment is specified for any SD or CM 
type symbol. For each segment, three cycles of scanning are 
performed. First, SDs and CMs having entries in the ORDER 
table are processed. The final address is calculated by 
adding the SRC and the temporary linked address, and is 
aligned on a page boundary, if required. A cumulative count 
of any increment within a segment caused by page alignment 
is kept, in order to assign correct addresses to the 
unprocessed SDs, PCs, and CMs. Next, the text I/0 table is 
scanned for the remaining SDs and PCs in the segment. These 
SDs and PCs are assigned final addresses. Finally, a scan 
of the CESD gives addresses to all unprocessed SDs, PCs, and 
CMs in the segment. For every processed SD, its entry in 
the relocation constant table is calculated. Before going 
on to the next segment, the length of the segment just 
processed and the SRC of the next segment are updated. 


Makes a final scan of the CESD to assign a final linked 
address to each label reference. 


The CESD entry for each LR contains a reference to the 
control section in which it resides. The relocation 
constant for that control section is located in the RCT and 
is added to the temporary linked address in the CESD entry 
for the LR. This sum, the final linked address for the LR, 
is placed in the CESD. 


Marks the program as not executable if there are still 
unresolved ERs and if neither the NCAL option nor the LET 
option has been specified. Unresolved WxXs do not inhibit 
program execution. 


Bullds the alias table and compute an entry point for the 
program (see "Entry Processing"™). 
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ENTAB Size Determination 


ENTAB size determination consists of computing the size of 
ENTABs so that the size of each segment in an overlay program 
can be determined, and relative relocation factors can be 
computed for use by second pass processing. The size is 
determined by the number of downward calls, or calls across 
regions, to symbols that are not referred to by segments higher 
in the path of the calling segments. 


An example of ENTAB size determination is given in Figure 19 on 
page 55. The overlay tree structure shown in the illustration 
consists of nine segments residing in two regions; all 
references between segments are made using V-type address 
constants. Functions of ENTAB size determination are: 


® Scanning the CESD for LR entries and entering their segment 
numbers. In Figure 19, item 6 is an LR item; its ID/length 
field points to the CESD entry for the control section in 
which it resides (line 3). The segment number contained in 
line 3 (segment number 3) is entered in the segment number 
field of the LR item. 


e Scanning the calls list, inserting chaining values that. 
point from one group of R and P pointers to the next. 


e Scanning the calls list for each segment (starting with 
segment 1), and finding symbols referred to by that segment. 
For each reference found, the type of call Cupward, 
downward, or exclusive) is determined. If an ENTAB is 
required for the segment, its size is determined and a 
PC-delete entry for the ENTAB is made in the CESD. 
Referring to Figure 19, the segments are processed in the 
following manner: 


1. The calls list is scanned for P pointers that refer to 
control sections in segment 1. If one is found, the 
associated R pointers (which refer to referenced 
symbols) are examined to determine the segment in which 
each referenced symbol resides. In Figure 19, the fifth 
P pointer refers to line 7 of the CESD, which contains 
an SD entry for a control section in segment 1. The 
associated R pointers refer to line 6 (symbol B in 
segment 3) and line 4 (symbol C in segment 5). For each 
reference, the type of call Cupward, downward, or 
exclusive) is determined, using SEGTAl and the segment 
numbers of the calling and called segments. In 
Figure 19, SEGTAl indicates that segment 1 is in the 
path of segments 3 and 5; therefore, the calls from 
segment 1 to B and C are downward calls. This is noted 
in the downward calls list by entering segment number 1 
in the lines referred to by the R pointer Clines 6 and 
4). Since segment 1 is the root segment, it must have 
an ENTAB; the size of the ENTAB is determined and a 
PC-delete entry for it is created in the CESD. 


2. When the scan for segment 1 is completed, the calls list 
is scanned for P pointers that refer to segment 2. In 
Figure 19, the third P pointer in the calls list refers 
to CESD line 6, which contains segment number 3. In 
this case, however, no entry is made in the downward 
calls list because it indicates a call to B in segment 3 
from segment 1, which is higher in the path of the 
calling segment (segment 2). No ENTAB is required for 
segment 2 because the reference to symbol B in segment 2 
can be resolved through the ENTAB entry in segment l. 


3. The calls list is scanned for P pointers that refer to 
segment 3. In Figure 19, the fourth P pointer in the 
calls list refers to CESD line 3 (segment 3). The R 
pointer refers to CESD line 8 (segment 8). SEGTAI 
indicates that the call from 3 to 8 is downward, across 
regions, and the call is noted in the downward calls 
list. Segment 3 requires an ENTAB, because it contains 
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a downward call to a symbol not referred to by a segment 
in the path of the calling segment; the ENTAB size is 
determined, and a PC-delete entry for the ENTAB is 
created in the CESD. 


The calls list is scanned for P pointers that refer to 
seqment 4. In Figure 19, the first P pointer in the 
calls list refers to CESD line 9 (segment 4). The R 
pointers refer to line 2 (segment 2) and line 8 (segment 
8). SEGTAl indicates that the call from 4 to 2 is 
upward, while the call from 4 to 8 is downward, across 
regions. The upward call is ignored, because the 
address constant can be resolved directly to the 
referenced symbol. The downward call from 4 to 8 is 
noted in the downward calls list, replacing the previous 
entry for segment 3 (because no segment with a segment 
number greater than 4 can have segment 3 in its path). 
Because an ENTAB is required, the size is determined and 
a PC-delete entry is created in the CESD. 


This process continues until all segments have been 
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Entry Processing 
Entry processing includes the following operations: 


e Entering in the alias table any alias symbols that were 
chained together and saved in the CESD by the ALIAS 
statement processor. Each entry in this table consists of 
an 8~byte symbol field and a 2-byte ESDID field. For each 
saved alias symbol, the entry processor scans the CESD for a 
matching SD or LR entry. If no match is found, a zero is 
Placed in the ESDID field of the alias table entry for the 
symbol. If a matching SD or LR entry is found, the ESD ID 
of the alias entry in the chain is placed in the ESDID field 
of the alias table entry for the symbol (see Figure 20 on 
page 57). The address assigned by linkage editor to the 
matching SD or LR and the ESD ID of its control section are 
placed in the CESD entry for the chained symbol, and the 
type of the chained symbol is changed to null. 


e Determining whether the entry point was specified as an 
address on an END record, or as a symbol on an ENTRY 
statement or END record: 


1. If the entry point was specified as an address on an END 
record, the assigned address is determined by either 
absolute or relative relocation. If the ID on the END 
record referred to an ER which was resolved with an SD 
or LR, the address assigned by the linkage editor to the 
SD or LR is added to the address from the END record 
Cabsolute relocation). If the ID on the END record 
referred directly to an SD or PC, the relocation 
constant for the SD or PC is added to the address from 
the END record (relative relocation). 


2. If a symbolic entry point was specified on an ENTRY 
statement or END record, the CESD is scanned for a 
matching SD or LR symbol. The address of the matching 
symbol is used as the entry point. 


3. If no entry point was specified, the starting address of 
the SD or PC control section Cnot marked delete) with 
the lowest assigned address is chosen as the entry 
point. The entry point associated with the main name 
(not an alias) and all alias entry points must be in 
segment 1 if the program is in overlay. 


e Assigning the addressing mode for the main entry point into 
the output load module. If the load module is in overlay 
format, the addressing mode is 24; otherwise, the addressing 
mode is obtained from the CESD entry that defines the SD or 
PC that contains the entry address. The addressing mode, 
along with the entry address and the ESDID of the SD or PC, 
is saved in the all-purpose table. 
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All Purpose Table 






Alias Chain Address 





CESD - Before Entry Processing 


t 


* Linked oddress 


Alias Table 


Figure 20. Processing of Alias Symbols by the Entry Processor 





INTERMEDIATE OUTPUT PROCESSING 


Intermediate output processing includes the following 
operations: 


® Writing out the CESD on SYSLMOD in groups of 15 entries per 
record. The last record may consist of less than 15 
entries. In writing CESD records on to SYSLMOD, the 
intermediate output processor sets a flag in the control 
information indicating the content of byte 12 in the CESD 
entries in the record. If the CESD entries contain segment 
numbers (that is, the load module is in overlay format), the 
flag is off; if the CESD entries contain AMODE/RMODE data, 
the flag is on. 


° Building and writing out the IDRs from the IDR tables 
CIDRTRTAB, IDRTITAB, IDRUDTAB, and IDRZPTAB) onto SYSLMOD. 
ave Mane editor IDR is also built and written on to 
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® Building a half ESD (HESD), consisting of the last 8 bytes 
of each CESD entry. (The symbol is deleted from each CESD 
entry to conserve virtual storage space during second pass 
processing.) The HESD is not complete at this time. (The 
ID of each label reference is used in building the scatter 
and translation tables. ) 


e Building and writing out the segment table CSEGTAB), 
preceded by a control record describing it if the program is 
in overlay. SEGTAB contains information required by the 
overlay supervisor. 


e Building and writing a l-byte text record if the first load 
module text record does not begin at address 0. The l-byte 
text record is preceded by a control record describing it. 


° Building a scatter table and a translation table for a 
Program that is to be scatter loaded, and writing out 
scatter/translation records in a form acceptable to program 
fetch at execution time. The scatter/translation 
information is written out on SYSLMOD in 1024-byte records. 
The first 4 bytes of each record are used to identify the 
records as scatter/translation information. If the length 
of scatter/translation information is greater than 1020 
bytes, the last 1020 bytes (plus 4 bytes of header 
information) are written out as the first 
scatter/translation record. The data in the last record may 
be 1020 bytes or less (see Figure 21). In creating the 
scatter table entries, the RMODE/RSECT data is obtained from 
the HESD entries (byte 4) and inserted into the flag byte. 


Low-Order Position 
Beginning of in Virtual Storage 
Translation —————— 


Teble 500 bytes 
Beginning of 4-byte header 
sally —-__-_———_—_— 1020 bytes 
e . 
= = 
1020 bytes C 
1024 bytes 1024 bytes 1024 byt 504 b 
1020 bytes : . _° 3 ai . 





i 


High-Order Position 
: Sequentiol Order of Records 


_in Virtual Storage 


Figure 21. Writing Scatter/Translation Records . 


e Determining the control section containing the last text in 
the program Cor in each segment if the program is structured 
for overlay) and the highest segment number of the segments 
that contain text. (This information is necessary so that 
second pass processing can determine when to set the 
end-of-segment or end-of-module indicator.) The highest ESD 
ID is determined by scanning the text I/0 table for the ESD 
IDs of control sections that contain text. This ESD ID is 
entered into the high ID CHIID) table along with its 
associated segment number. 


e Determining, via bits in the all-purpose table CAPT), if the 
MAP option has been specified, or if the XREF option has 
been specified and all RLDs are in storage. If either of 
these conditions exists, the module map and/or the 
cross-reference table are produced. If the XREF option is 
specified and all RLDs are not in storage, XREF processing 
will be done as part of final processing. 
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e If the ORDER option has been invoked during input 
processing, the text I/0 table and the text note list II 
(formed after merging all text note lists from SYSUT1l) are 
sorted according to the ORDER table. The sorting, however, 
preserves the original order for those control sections that 
do not have entries in the ORDER table. 


MAP/XREF Processing 


When MAP/XREF processing is performed as part of intermediate 
output processing, a table address is obtained from the APT, and 
a table of 2-byte entries pointing directly to the CESD is 
constructed. The CESD records for the current segment are 
gathered and sorted by address. The module map is then printed 
out; the map lists, in ascending order according to their 
assigned origins, all control sections contained in the output 
module and the entry points within the control sections. 

oe sections in an overlay output module are grouped by 
segment. 


If XREF processing is done during intermediate output 
processing, RLD items are incompletely relocated; their 
addresses are relative to the origins of their respective CSECTs 
rather than the origin of the load module, and the address of 
each RLD must be added to the linkage editor assigned address of 
its corresponding control section before the cross-reference 
table is produced. The cross-reference table includes a module 
map anda list of all references within a given segment that 
refer across control section boundaries. Each entry in the list 
contains the address of the reference, the symbol to which it 
refers, and the name of the control section in which the symbol 
is defined. For overlay programs, each item in the list also 
ee the number of the segment in which the symbol is 
efined. 


If the MAP and XREF options are processed during intermediate 
output processing, disposition messages and the diagnostic 
message directory are printed after the module map and 
cross-reference table. If the cross-reference table is produced 
during final processing, the disposition messages and the 
diagnostic message directory are printed before the 
cross-reference table. 


SECOND PASS PROCESSING 
Second pass processing comprises modules HENLFSCD and HEWLFREL. 


After intermediate processing is completed, the third phase of 
the linkage editor (second pass processing) begins operation 
(see "Diagram 14. Data Movement During Second Pass Processing"™ 
on tobi 88). The major functions of second pass processing 
include: 


® Relocating address constants contained in the text. 
e Creating control/RLD records. 


® Wrating TXT and control/RLD records on SYSLMOD in a format 
that can be loaded by program fetch. Included in the 
control information of the control or control/RLD record 
that precedes each text record is a count of the RLD and 
control/RLD records that follow the text record. This count 
is used by program fetch to build optional channel programs 
when Loading the load module. 


@ Creating ENTABs and associated RLD items for overlay 
modules. 
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SINGLE PASS PROCESSING: Indicators residing in virtual storage 
in the text I/0 table and the RLD note list are checked to 
determine whether text and RLD records have been written on 
SYSUT1, or have been retained in the input text buffer and the 
RLD buffer. If either text or RLD records have been retained in 
storage, single pass processing is in effect for that record 
type. If two pass processing is in effect, the records are read 
into the buffers from SYSUT1. 


ORDERING OF TEXT: In two pass processing, the ID sequence in 
the text I/0 table is used to determine the order in which 
CSECTs are to be read into the second pass text buffer (which is 
physically the same storage area as the input text buffer). The 
text 1/0 table entry for each ID and the corresponding text note 
list entry are used to locate text on SYSUT] (see "Diagram 14. 
Data Movement During Second Pass Processing" on page 88, area 
A). Text is read into the buffer one multiplicity at a time, 
using the displacement field in the text note list to determine 
where within the buffer the text must be placed. Information 
about the text is entered into the second pass text control 
table, which is used to control subsequent processing of the 
text Carea B). 


SECOND PASS RLD BUFFERS: When the required text is in the text 
buffer, the corresponding RLDs are read into the RLD input 
buffer, using the RLD note list to locate the RLD records (area 
C). The RLD input buffer can contain two RLD records from 
SYSUT1; for each RLD input buffer area, an RLD input control 
block is maintained (area D). The RLD output buffer is 768 
bytes long and is divided into three buffer areas (the maximum 
RLD output record is 256 bytes long); for each RLD output buffer 
area, an RLD output control block is maintained Carea F). While 
text is being relocated, the control record for that portion of 
text occupies one of the output buffers; the other two output 
buffers contain the relocated RLDs for the text being processed 
Carea E). If the relocated RLDs exceed two buffers, the control 
record is written on SYSLMOD; relocated RLDs may then be moved 
into the third output buffer. 


When all three RLD output buffers and the RLD input buffers are 
filled and additional RLDs are required to relocate the text 
currently being processed, the contents of the output buffer 
must be written out. However, to maintain the required TXT/RLD 
sequence in the output module Carea G), the associated text must 
precede the RLD record. Space for the text is reserved in the 
output module by writing the incompletely relocated text; the 
contents of the RLD output buffer may then be written, and 
processing can continue. When the text is completely relocated, 
it 1s written over the space reserved for it using the X 
("execute direct access program™) macro instruction. 


GROUPING SYSLMOD OUTPUT: As many CSECTs as will completely fit 
in one SYSLMOD record Cup to a maximum of 60) are grouped and 
written as one record. RLDs are grouped to correspond to the 

grouping of their associated text. If the overlay attribute is 
pled a ar only CSECTs belonging to the same segment will be 
grouped. 


If a CSECT is larger than the SYSLMOD record size, the CSECT is 
divided into multiplicities, each multiplicity being equal to 
the SYSLMOD record size. The length of the last multiplicity 
may be less than the SYSLMOD record size. Each multiplicity is 
written as a record, followed by RLDs associated with only that 
multiplicity. 


Note: If the downward compatible attribute (DC) or the scatter 


format attribute (CSCTR) is specified, CSECTs will not be 
grouped. 
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ENID-OF-MODULE: When control sections for all segments of the 
output load module have been processed (determined via the "high 
ID" indicator in the HESD type field and the "last segment with 
text™ field in the all-purpose table), indicators are set in the 
last control/RLD record to mark it as the end of the module. 

The control/RLD record is written out on SYSLMOD, and second 
Pass processing 1s completed. 


Note: If the output load module is to be structured for 
overlay, a list of relative track addresses (CTTR list) is 
created to be used by program fetch when it loads the segments 
into virtual storage for execution. The TTR list contains one 
entry for each segment in the overlay load module. Each entry 
contains the relative track address of the first record (control 
record) of a segment, except for the first segment, which 
contains the relative track address of the first text record. A 
PC-delete control section that contains ENTAB entries in each 
segment where the text requires them and the RLD records 
required by program fetch to relocate address constants 
contained in the ENTAB entries are also created. The fourth 
byte of each entry contains the number of blocks of the text in 
the corresponding segment, or 255 (X'FF') if there are more than 
255 blocks of text. 


Relocation of Address Constants 
There are two types of relocatable address constants: 
® Branch-type, such as DC V(X) 
e Nonbranch-type, such as DC ACX) 


The value of a branch~type or nonbranch-type address constant 
depends on a symbol in the CESD. To adjust an address constant 
to its proper value in the output load module, the linkage 
editor uses an absolute or relative relocation factor. The 
absolute relocation factor is the address assigned by the 
linkage editor to the symbol on which the value of the address 
constant depends. The relative relocation factor is the 
difference between the address assigned to the symbol by the 
linkage editor and the address of the symbol in the input 
module. The relative relocation factor may be positive or 
negative.?% The absolute and relative relocation factors of 
each symbol in the CESD are computed during address assignment 
and are saved in the half ESD CHESD). 


Relocation of Nonbranch-Type (A-Type) Address Constants 


A relative relocation factor is used for a nonbranch-type 
address constant if the symbol on which its value depends is in 
the same input module as the control section that contains the 
address constant. (The address constant and the symbol it 
refers to were assembled or compiled together, or were 
previously processed together by the linkage editor.) An 
example of relative relocation of nonbranch-type address 
constants is shown in Figure 22 on page 62. Because the address 
of DICK is known, the language translator places it in the value 
of the address constant. DICK is a Known value prior to linkage 
editor processing (not an external reference in the input); 
therefore, a relative relocation factor (+1000) is used to 
relocate DICK during linkage editor processing. 


10 If it is negative, an indicator is set in the HESD to note 
that it is in complement form. 
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input Module 1 Output Module 





Input Module 2 


Linkage 
Editor 





Legend: 
* Known value of DICK is inserted by language translator. 
t Relative relocation factor is +1000; linkage editor assigned address is 2000. 





Figure 22. Nonbranch-Type Address Constants—Relative Relocation 


An absolute relocation factor is used for a nonbranch-type 
address constant if the symbol referred to by the address 
constant does not have a defined value within the same input 
module. (The R pointer of the RLD item refers to an external 
reference.) An example of absolute relocation of a 
nonbranch-type address constant is shown in Figure 23 on 

page 63. In this example, the value of SAM is unknown when 
input module 1 is processed by the language translator; 
therefore, zeros are placed in the value of the address 
constant. During second pass processing, the absolute 
relocation factor (the linkage editor assigned address) is used 
to relocate the address constant. 
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Figure 23. 
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Legend: 
* Language translator inserts zeros becouse value of SAM is unknown, 
+ Actua! address of SAM in the output module (0500) is added to value 

of address constant. 


Nonbranch-Type Address Constants—Absolute Relocation 


Figure 24 on page 64 shows the use of both a relative relocation 
factor and an absolute relocation factor in relocating a symbol. 
Two input modules are to be processed by the linkage editor. 
Input module 1 contains a nonbranch-type address constant whose 
value depends on the symbol PETE; PETE is an external reference 
in the same module. The language translator has assigned a 
value of +10 to the address constant. The R pointer of the RLD 
item refers to the ER entry for PETE in the ESD; this entry 
contains zeros in the origin and length fields. The P pointer 
refers to the SD entry for the control section that contains the 
address constant. 


Input module 2 contains two control sections, BOB and PETE. BOB 
contains a nonbranch-type address constant whose value depends 
on PETE; because PETE has a defined value of (300) in the same 
module, the language translator has used that value to compute 
the value of the address constant (PETE + 10 = 310). The R 
pointer of the RLD item refers to the SD entry for PETE in the 
ESD; the P pointer refers to the SD entry for BOB (the control 
section that contains the address constant). 


During linkage editor processing, the ER and SD entries for PETE 
are merged into one CESD entry; the R pointers of both RLD items 
in the output module will refer to that entry. The RLD P 
pointer for the address constant in control section BILL will 
refer to the SD entry for BILL; the P pointer for the other 
address constant will refer to the SD entry for BOB. In the 
output load module, both address constants will contain the same 
value. Because the R pointer of the RLD item in input module l 
refers to an ER entry in the ESD in that module, it is marked 
for absolute relocation; the absolute relocation factor for PETE 
(+500) is added to the value (+10) assigned by the language 
translator. Because the R pointer of the RLD item in input 
module 2 refers to an SD entry in the ESD in module 2, it is 
marked for relative relocation; therefore, the relative 
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relocation factor for PETE (+200) is added to the value (+300) 
assigned by the language translator. The relocated value for 
both address constants is 510. 


Relocation of all nonbranch-type address constants requires an 

addition or subtraction of the relocation factor to or from the 
value of the address constant in the text of the input module. 

CAddition or subtraction 1s specified in the flag field of the 

RLD item for the address constant.) 





Input Module 1 Output Module 


De Origin Length 
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24. #Nonbranch-Type Address Constants—Absolute and Relative Relocation 
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Figure 25. 






DELINKING NONBRANCH-TYPE ADDRESS CONSTANTS: A relative 
relocation factor cannot be used to relocate an A-type address 
constant that refers to a symbol in a control section being 
replaced. Because the address constant has been previously 
relocated (by a language translator or by the linkage editor), 
it contains the value of a symbol being replaced; therefore, the 
value of that symbol must be subtracted from the value of the 
address constant. This process is called delinking. In 
delinking, an address constant is reduced to the value it would 
have contained if it referred to an external reference in the 
input module. After delinking, the address constant contains 
the value required for proper relocation, should the replaced 
symbol appear later in the input in another control section. 
Delinked address constants are treated as address constants 
whose values depend on external references. (CAbsolute 
relocation factors are used in relocating them. ) 


Delinking of an A-type address constant is shown in Figure 25. 
Input load modules A and B both contain control section SAM. 
During linkage editor processing, the first occurrence of 
control section SAM is accepted, while the second occurrence is 
deleted through automatic control section replacement. 


Output Module 


Linkage 
Editor 






Legend: 
* Values ore derived from HESD. 
** 1100 + 800 = 1900. 
£ 120 - 70 + 1850 = 1900. 

e A relative relocation factor is used to relocate the address constant A(JOHN+50) in 
control section JOE, because JOE and SAM are in the same module. 

@ The address constant A(JOHN + 50) in control! section BILL must be delinked because 
it was resolved with the symbol JOHN in the repiaced contro! section SAM. The old 
value of JOHN must be subtracted from the value of the address constant before it 
can be relocated (using the absolute relocation factor) to the new value of JOHN in 


the output load module. 
Delink Table 


0004 000070 
Relocation Constant Table 


Absolute Reloe Fact 
| 800000 
| 001000, 





00 
00 

[00 | 001800 
To [001850 


Example of Delinking 
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Control section BILL in module B contains a reference to symbol 
JOHN in control section SAM. Because SAM in module B will be 
deleted, the address constant A (JOHN+50) in module B must be 
delinked so that it may be properly resolved with the symbol 
JOHN in module A. In delinking, the old value of JOHN is 
subtracted from the value of the address constant in BILL 
€120-70=50). The absolute relocation factor for JOHN (1850) is 
then added to the delinked value of JOHN (€504+1850=1900). 


DELINKING COMMON CONTROL SECTIONS: Common control sections 
Ceither blank common or named common) must be "delinked™ by the 
linkage editor. All references to common control sections are 
made by means of nonbranch-type address constants. 


If the assigned address of a common control section in the input 
to the linkage editor is not zero, all such references must be 
delinked. Delinking is necessary, because during linkage editor 
processing all blank common control sections are collected into 
a single control section. All identically named common control. 
sections are gathered into individual control sections; 
references to them from different input modules must be delinked 
so that they can be properly relocated with respect to the | 
locations of the common control sections in the output module. 


Delinking adjusts the value of each address constant in a common 
control section so that it contains its correct displacement 
from the control section origin. The values of such address 
constants are then relocated so that they refer to the linkage 
editor-assigned addresses, uSing absolute relocation factors. 


Relocation of Branch-Type (V-Type) Address Constants 


Only absolute relocation factors are used to relocate 
branch-type address constants. Because a displacement is not 
allowed in the value of a V-type address constant, the absolute 
relocation factor is inserted in the value field during 
relocation. (It is not added to or subtracted from in value 
assigned by the language translator, as described for A-type 
address constants.) Because the value of a V-type address 
constant is inserted, delinking is never necessary for such 
address constants. Relocation of V-type address constants in an 
overlay structure is discussed in the following paragraph. 


RELOCATION OF V-TYPE ADDRESS CONSTANTS IN OVERLAY: If the 
output of the linkage editor is to be overlay load module, a 
G-byte?!? branch-type address constant in the path of the symbol 
it refers to (but in a different segment), or ina different 
region, will be relocated in a special manner. The value field 
of the address constant will contain the address of an ENTAB 
entry. The ENTAB entry will contain the address assigned by the 
linkage editor to the symbol referred to by the value of the 
address constant. An ENTAB entry is created for each V-type 
address constant that is in the path of the symbol it refers to 
(but is not in the same segment), or located ina different 
region, provided that the symbol is not referred to in a segment 
higher in the path of the calling segment. (Such address 
constants are resolved so that they refer to the ENTAB entry 
previously created for the symbol in the higher segment.) ENTAB 
entries are not created for address constants that refer to 
symbols higher in the path. Whenever an ENTAB entry is created, 
it is noted in an entry list; each item in the entry list 
contains the entry number of the referenced symbol in the HESD, 
the segment number of the calling segment, and the address 
assigned to the ENTAB entry by the linkage editor. The ENTAB 


11 Any address constant must be 4 bytes, because the high-order 
byte is used by the overlay supervisor during execution. 
The number of the segment containing the address constant 
will be placed in the high-order byte of any V-type address 
constant resolved to an ENTAB entry. (The high-order byte 
must be zero if it is not resolved to an ENTAB entry.) 
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creation routine uses the entry list to build ENTAB entries (see 
"FNTAB Creation"™). 


When second pass processing begins to process a segment, the 
entry list is modified so that is contains only entries for 
segments higher in the path of the current segment. (In 

Figure 26, segment 4 is being processed; the entry for segment 3 
is removed because it is not higher in the path of segment 4.) 





Next 

available 
Current line; 4 
Segment will be 


entered 
here, 





Figure 26. Entry List Processing 


During relocation, each V-type address constant 1s examined to 
determine if an ENTAB entry must be created for it. The R 
pointer of the RLD item for the address constant is used to find 
the associated HESD entry; this entry contains the segment 
number of the symbol referred to by the address constant. The 
relationship of this segment to the current segment is then 
determined, using SEGTAl. Depending on the relationship in 
SEGTAl1, the address constant is relocated in one of three ways: 


1. If the segment that contains the symbol is higher in the 
path of the current segment, the call is upward and the 
address constant is resolved directly. (The absolute 
relocation factor of the symbol is inserted in the value of 
the address constant. ) 


2. If the current segment is higher in the path of the segment 
that contains the symbol, the call is downward. The entry 
list is checked to determine if an ENTAB entry was 
previously created for the symbol in this segment, or ina 
segment higher in the path of this segment. If an ENTAB 
entry for the symbol exists, its address (contained in the 
entry list) is placed in the value field of the address 
constant. If no ENTAB entry exists for the symbol, a new 
entry is placed in the entry list, and an ENTAB entry will 
be created by the ENTAB creation routine (see "ENTAB 
Creation"). The ENTAB entry will contain the address 
assigned to the symbol by the linkage editor, and the 
address of the ENTAB entry will be placed in the value of 
the address constant and in the entry list item. 


3. If neither of the two segments is higher in the path of the 
other, the call is either exclusive or across regions. 
the two segments are in different regions, and no ENTAB 
entry already exists for the symbol in the entry list, an 
ENTAB entry will be created and an entry is made in the 
entry list; the value field of the address constant is 
relocated to the address of the ENTAB entry, which in turn 
contains the relocated address of the symbol. If the two 
segments are in the same region, the call is exclusive. If 
there is an entry in the entry list for the symbol, the 
address constant is resolved through its ENTAB entry; if 
there is no entry for the symbol in the entry list, the call 
is an invalid exclusive call and the address constant is 
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resolved directly to the symbol. (This usually leads to © 
incorrect results during execution of the module. ) 


ENTAB Creation 


The ENTAB creation routine uses the size field in the HESD to 
determine the number of ENTAB entries to be created for a given 
segment. The entry list is scanned for all entries that were 
created for the current segment; each of these entries contains 
the HESD entry number for the corresponding symbol. The value 
and segment number of the symbol are obtained from the HESD and 
are entered in the ENTAB entry, along with standard information 
shown in the table format (see "Table Layouts"™). 


ENTAB creation is shown in Figure 28 on page 70. The V-type 
address constants referring to SAM and BILL in segment 1 meet 
the requirements for building ENTAB entries. The ESD and RLD 
input to the second pass processor, and the overlay tree 
structure are shown in Diagram A. During relocation, entries 
are created for SAM and BILL in the entry list (see Diagram B); 
each entry contains the address of the ENTAB entry created for 
the address constant. 


In segment 1, location 136 of control section JOE contarnes a 
call to control section SAM before relocation. Afte 

relocation, location 136 contains the address of oat ENTAB eAtiy 
for SAM, and the high-order byte of the address constant 
contains the segment number of the calling segment. An ENTAB 
entry is created, in like manner, for BILL in segment l. 


In segment 2, the address constant referring to BILL does not 
meet the requirements for building an ENTAB entry. (It is not 
in the path of the segment containing the symbol.) Therefore, 
no ENTAB is created in segment 2. The call for segment 2 to 
BILL in segment 3 is an exclusive call. Because a call to the 
Same symbol appears in a higher segment common to 2 and 3 
(segment 1), the address constant may refer to the ENTAB entry 
for BILL in segment 1. (This is determined by scanning the 
entry list for the HESD entry corresponding to the symbol BILL.) 


If a call to BILL was not contained in a common segment, the 
address constant DC V (BILL) in segment 2 would be resolved 
using the value assigned by the linkage editor to the symbol 
BILL, which results in an error. 


In segment 3, the address constant is an upward call and is 
resolved directly. 


Relocation Routine 


The relocation of address constants is performed by the 
relocation routine; the routine operates on the following input 


data: 

e The address of the RLD input buffers that contain RLD 
records 

e The address of the RLD note list entry for the RLDs being 
processed 


e The address of the next available entry in the RLD output 
buffer 


e The buffer relocation constant CBRC) where: 
BRC = starting buffer address of current text + relative 
relocation constant of current control section - address 


assigned to current control section by the linkage editor - 
multiplicity size x current multiplicity number 
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- Input 
Flag Type 
OOOOLLST Absolute 


OOOLLLST Branch 


Cutput 
Action Performed Flag Type 


Absolute relocation OOOOLLST A-type 
factor is added to 

value of address 

constant 


Absolute relocation OOOILLLST 
factor is inserted 

into value of 

address constant 


OOLOLLST PR displacement Absolute relocation OOLOLLST PR displacement 


value 
CPR type 1) 


factor is inserted value 
into value of 
address constant 


OCLOLLST PR cumulative PR length from all OOLILLST PR cumulative 
displacement purpose table is displacement 


value 
(PR type 2) 


LOOOLLST Relative 


inserted into value value 
of address constant 


Relative relocation OOOOLLST 
factor is added to or 
value of address 

constant 





Figure 27. Relationship of RLD Flag Field to Relocation 


Notes to Figure 27 on page 68: 


l. 


If S (sign) in LIST is 1, subtraction is performed, rather 
than addition. 


In delink type, the delink value is added or subtracted 
according to the opposite of the sign; the absolute 
relocation factor is added to or subtracted from the address 
constant according to the indicated sign. : 

If an RLD item refers to an undefined symbol, the associated 
address constant is not relocated. (It may have been 
delinked.) The high-order bit of the RLD item flag field is 
set to one CLOOOLLST for an A-type constant, lOOLLLST for a 
V-type constant), and no relocation will be performed when 
the module is loaded into virtual storage for execution. 


Delinking is noted in the high-order bit of the P pointer. 
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ENTAB a Segment 2 Segment 3 
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R Fle Address 
RLO [2] 1 | JC 7100.) Structure with V-type address 
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Input RLDs - Segment | * Zero value assigned by the assembler. 
Diagram B. 
Output RLD Buffer Entry List Entab RLD Items 
a oe 1 a es ee ee Xe a | eZ 
a ee ee eS 7 eae eae | ee 
RLDs and Entry List ofter relocation for control section JOE. 
Diogrom C. 
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1% 
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236 [aver 0024 [00000272 02 | 000000 
248 47FF 0012 00000 272, | 03 {| 000000 | } ENTAS 
260 Standard Lost ENTAB Entry 
Diogram D 
Segment 2 ofter processing by Second Pass Processor. 
272 | SAM 
02000248 © 
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input RLO Buffer Output RLD Buffer ENTAB RLD Items Entry List 


[3_y]2 ,i |e) (Cs | 2 ) 1¢ | 752] er tte ee ee 


* Same as ofter processing segment |. 





Diagram E. 
Segment 3 ofter Second Pass Processing 
BILL 
00000036 
OC VUEFT 
Input RLO Buffer Output RLD Buffer ENTAB RLD Items Entry List 


~7_] 3 Tic | 690 Es Oo 07 EEC ae ee ee 


* Same as ofter processing segment | 
Figure 28. ENTAB Creation 
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The relocation routine operates in the following manner: 


1. The size of the RLD set!# and the displacement from the 
peas ans of the buffer are determined from the RLD note 
ist. 


2. Each RLD item in the current RLD set is scanned to determine 
whether: 


a. It describes an address constant for the current text 
being processed (BRC + address contained in the RLD 
address field falls within the text buffer boundaries of 
the current text.) | 


b. The address constant is either a valid 2-, 3-, or G-byte 
address constant. (The only valid 2-byte address 
constants are defined by pseudo register symbols. ) 


3. Each address constant whose RLD meets the above requirements 
is moved from the text into a computation area. The address 
constant associated with the RLD item is then relocated 
according to the information in the flag field of the RLD 
item (see Figure 27 on page 68). In relocating 4-byte 
address constants (VCONs), the high-order bit in the address 
constant before relocation is reproduced in the address 
constant after relocation. The relocated address constant 
is then placed back into the text. 


G4. The RLD address field is updated using the relative 
relocation factor for the control section being processed. 
pee eee section referred to by the P pointer of the RLD 
item). 


5. The RLD is moved into the RLD output buffer if space is 
available. If space is not available, the contents of the 
RLD output buffer are written out on SYSLMOD. See "Second 
Pass RLD Buffers™ under "Second Pass Processing."™ 


6. Steps 2 through 5 are repeated until all RLD items have been 
scanned in the RLD set being processed. The multiplicity 
number in the RLD note list is updated if unprocessed RLDs 
remain in the set. 


7. If there are more RLD sets in the input buffer to be 
processed, the address of the next record is determined and 
steps 1 through 6 are performed. 


Note: To minimize the number of times RLD records are read from 
SYSUT]L, RLD records for a control section are held in the input 
RLD buffer, when possible, until all RLD records in the buffer 
have been processed (because each RLD record may pertain to many 
multiplicities of text). After each set of RLDs is scanned, the 
multiplicity number in the RLD note list is updated to reflect 
the multiplicity of the remaining unprocessed RLD records in the 
set. An RLD record is removed from the buffer when: 


e All RLD items in the record have been processed. (Their 
associated address constants have been relocated. ) 


° Another RLD record must be read into the buffer and space 1S 
not available. 


When all records in the input RLD buffer have been scanned, the 
relocation routine determines if more RLD records for the 
current multiplicity of text are to be read in. (The RLD read 
routine sets an indicator when it encounters such a record but 
cannot read it into the buffer because the buffer is full.) 
Mhen both buffers are full, the second buffer is freed, anda 
bit is set in the corresponding RLD note list entries which 


12 An RLD set is a group of RLDs referred to by a particular 
RLD note list entry. 


LY26-3963-0 @©@ Copyright IBM Corp. 1972,1985 Method of Operation 71 


Contains Restricted Materials of IBM 
Licensed Materials ~~ Property of IBM 


indicates that the RLDs are not in virtual storage. The records 
to be read in are then placed in the second RLD buffer; these 
records are processed in the same manner as those already | 
residing in the first buffer. This process is repeated until 
all records that contain RLD items pertaining to the current 
multiplicity of text have been scanned and processed. 


When all RLDs in a buffer are processed, the buffer is marked 
"free" in the RLD control block. When a new multiplicity of 
text is to be relocated, the RLD note list is scanned 
sequentially Con ID and multiplicity number) from the first 
entry. If an entry indicates that the record is "in virtual 
storage" and the record contains RLD items pertaining to the new 
multiplicity of text, it 1s processed. 


FINAL PROCESSING (HEWLEFNL ) 


Final processing comprises modules HEWLFFNL, HEWLFBIP, and 
Coptionally) HEWLFMAP. 


The fourth phase of the linkage editor (final processing) 
performs "cleanup" functions, and is the last operation of the 
i uneae editor processing. Functions of final processing 
aneiuqgae: 


@ Writing the TTR note list, created during second pass 
processing, on SYSLMOD if the output load module is to be 
used in overlay. The TIR list contains the relative track 
address of the first record of each segment of the overlay 
load module. It is used by the overlay supervisor to find 
the segments when it loads them into virtual storage for 
execution. 


e Placing each entry in the proper format for the partitioned 
data set directory, modifying it if there are alias symbols, 
and issuing a STOW macro instruction?* for the member name 
and each alias. 


® Checking attributes (reusable, reenterable, and 
refreshable). If the attributes have become more 
restrictive, a message describing the change in attributes 
is printed out. (For example, the input module was 
specified as "reusable" and is now "not reusable.™) 


e Printing out a directory of logged errors. 


® Producing a MAP or a cross-reference table if the MAP or 
XREF option is specified, and the MAP or cross-reference 
table was not produced during intermediate output 
processing. If the MAP alternate 2-byte table is too small, 
warning message IEW0801 is issued. 


@ Printing a diagnostic message if the module has been marked 
Pnot executable." 


® Reinitiating linkage editor processing, beginning with 
initialization, if a NAME statement terminated SYSLIN input. 


® Completing linkage editor processing if end-of-file 
terminated SYSLIN input; releasing virtual storage and 
returning control to the caller. 


13° The STOW macro instruction is not issued if there was no 


valid input, if there were no ESDs, if nothing was written 
out on SYSLMOD, or if the run was terminated by a severity 4 
error. 
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Error Logging 


Whenever an error condition is detected during linkage editor 
processing, an indicator is set in an error logging map and a 
coded diagnostic message is printed out. During final 
processing, the error logging map is scanned. When an indicator 
is found "on" in the map, an associated list is used to build a 
diagnostic message. 


Note: An example of error logging is given in Figure 29. Each 
entry in the list contains a length indicator and a pointer to a 
phrase to be assembled into the message. (Phrases are stored to 


Save virtual storage space; complete messages would require 
additional space because of repetition of identical phrases.) 
The diagnostic directory is then printed out, one or two lines 
to a message. This directory is normally directed to the 
SYSPRINT data set. However, if the TERM option was specified, 
diagnostic messages are directed to both the SYSPRINT and 
SYSTERM data sets. 





Error Logging Map 


Pee Ae 


0 16 63 64 127 


mmm i ie ee Oe eC 


Table 


ie 
- 


/ \ aan 
BSS ae ee ee “ ra Wie, eee ee 

Phrases 

ee ee Coo 
Messege 

ee Cc 

Legend: 
* This pointer is determined by subtracting the bit number from the length 
of the error logging map (64 - 16 = 48). 

Figure 29. Building Error Messages 


All error messages produced by the linkage ear oe are identified 
by a message ID having the format: 


TEWDMMS 

where: 

IEW identifies the message as a linkage editor error message. 
D contains a zero. 

MM is the message number. 

S is the severity code. 


The module in which an error message occurred is identified by 
the message number (MM; see Figure 68 on page 189). 


t 
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Cross-Reference Table 


If the XREF option is specified and the cross-reference table 
was not produced during intermediate output processing, the RLD 
records are read back from SYSLMOD and the cross-reference table 
is built, as described in the discussion of intermediate 
processing. 
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DIAGRAM 8. CONTROL STATEMENT PROCESSING 
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DIAGRAM 13. ADDRESS ASSIGNMENT 
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PROGRAM ORGANIZATION 


The following text and the flowcharts at the end of this section 
describe the processors (code modules, control sections, and . 
routines) that accomplish the functions of the linkage editor. 
The organization of this section corresponds to the organization 
of the linkage editor; descriptions of all processors that 
constitute a phase of the linkage editor are grouped together. 
For each processor, the symbolic name is given to facilitate use 
of program listing (see "Microfiche Directory"), and the 
descriptive name is given to facilitate reference to "Method of 
Operation." 


Figure 31 on page 97 shows the overall organization of the 
linkage editor; this illustration is designed to help determine 
relationships among the processors described in this section. 


INITIALIZATION AND INPUT PROCESSING 


Initial Processor~"“HENLFINT (Chart BA) 


Entrance: HENLFINT is entered from HEWLFROU at the beginning of 
linkage editor processing. 


Operation: HENLFINT performs initialization functions, 
including building the all-purpose table CAPT), analyzing 
attributes and options passed by the calling program, opening 
data sets, and allocating virtual storage for buffers and work 
areas. 


Routines Called: HENLFINT calls the attributes and options 
processor CHEHMLFOPT) and the allocation routine (ALL001). The 
HEWLFINT routine is recalled immediately upon returning from the 
first call of the allocation routine CALLOO]). 


Exits: When initialization 1S completed, HEWLFINT passes 
control to the input processor CHENLFINP). 


Attributes and Options Processor~—HEVWLFOPT 
Entrance: HEWLFOPT is entered from the initial processor. 


Operation: HENLFOPT analyzes the options requested and the 
attributes specified by the calling program, and notes this 
information in the APT. If a valid authorization code is found, 
it is converted to binary and stored in both the default field 
and the PDS entry field of the APT. 


Routines Called: None. 
Exits: When attribute and option processing is completed, 
HENLFOPT returns control to the initial processor CHENLFINT). 
Allocation Processor~~ALL001 (Chart BA) 

Entrance: HENLFOPT is entered from the initial processor. 


Operation: ALLOO] issues the GETMAIN macro instruction and 
assigns storage to buffers. 


Routines Called: ALLOO1 calls the table allocation processor 


CHEWLFALK) to allocate storage for fixed-length and 
variable-length tables. 
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Exits: When allocation processing is completed, ALLO01 returns 
control to the initial processor CHEWLFINT). 


Table Allocation Processor-“HEWLFALK (Chart BB) 


Entrance: HEWLFALK is entered from ALLO001 after storage has 
been allocated for the buffers. 


Operation: HEWLFALK assigns storage to the internal tables. 
HENLFALK checks minimum required to available storage. If 
insufficient, an error message CIEW0664) will be issued. 
HEWLFALK determines the amount of storage in excess of the 
minimum required. This excess is used to expand proportionately 
the variable-length tables over the minimum required. 


Routines Called: None. 


Exits: When table allocation processing is completed, HEWLFALK 
returns to the calling routine. 


Input Processor~"HEWLFINP (Chart CA) 


Entrance: HEWLFINP receives control from the initial processor 
when all initialization functions are completed. 


Operation: HEWLFINP reads and initially processes all linkage 
editor input. Input type Cobject module or load module) and 
input conditions are determined, and control is passed to 
appropriate processors. 


Routines Called: HEWLFINP calls the following processors: 


e Control statement scanner CHENLFSCN) when a control 
statement is detected (blank in column 1) 


e Object module processor CHEWLFMDI) when object module input 
eeeee ae CSYSLIN input or fixed (F) format input from 


e Load module processor CINP270) when load module input is 
detected Cundefined (CU) format input from SYSLIB) 


e Include processor CHEWLFINC) at end-of-input if more modules 
must be included 


e Automatic library call processor (HEWLCAUT) at end-of-input 
on SYSLIN if the NCAL option is not specified 


Exits: When input processing is completed, HEWLFINP passes 
control to the address assignment processor (CHENLFADA), if valid 
input was received. If no valid input was received, control is 
passed to the final processor CHENLFENL) to terminate linkage 
editor processing. 





Object Module Processor~"“HEWLFMDI (Chart CB) 


Entrance: HEWLFMDI is entered from the input processor when 
object module input is detected. 


Operation: HEWLFMDI determines the input record type (SYM, TXT, 
RLD, ESD, END), loads input record information into general 
registers, and passes control to the appropriate processors. 


Routines Called: Depending on input record type, HEWLFMDI calls 
the following processors: 


SYM processor CHEWNLFSYM) 
ESD processor CHENLFESD) 
END processor CHEWLFEND) 
Text and RLD processor CHEWNLFRAT) 
IDR processor CHENLFIDR) 
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Exits: bKhen object module processing is completed, HENLFMDI 
returns control to the input processor. 


Load Module Processor—~—INP270 (Chart CC) 


Entrance: INP270 is entered from the input processor when load 
module input is detected. 


Operation: INP270 determines the input record type (TXT, CESD, 
scatter/translation, SYM, CCW, CCW/RLD, RLD, IDR), loads input | 
record information into general registers, and passes control to 

the appropriate processors. 


Routines Called: Depending on input record type, INP270 calls 
an associated processor, as shown in Figure 30 


Exits: When load module processing is completed, INP270 returns 
control to the input processor. 


Record Type Processor 


TXT HEML FRAT 
CESD HEWLFESD 
Bone seeing or (Ignored) 
SY 


HEWLFSYM 
CCN HEWLFRAT 
CCW/RLD HEWL FRAT 
RLD HEWNLFRAT 
IDR HEWLFIDR 





If end-of-module indicator is on: 


CCH HEMNLFEND 


CCH/RLD HEWLFEND 
RLD HEWLFEND 





Figure 30. Load Module Record Types and Associated Processors 


SYM Processor-~HEWLFSYM (Chart CD) 


Entrance: HEWLFSYM is entered from the object module processor 
when SYM records have been detected and the TEST attribute has 
been specified. If TEST is not specified, SYM records are 
ignored. 


Operations: HEWLFSYM gathers SYM records in the RLD input 
buffer, and writes the buffer contents on SYSLMOD when the first 
TXT record of a module is detected. 

Routines Called: None. 


Exits: When SYM processing is completed, HEWLFSYM returns 
control to the object module processor. 
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ESD Processor~""HENLFESD (Chart CE) 


Entrance: HEWLFESD is entered from the object module processor 
when an ESD record is detected, and from the load module 
processor when a CESD record is detected. 


Operation: HEWLFESD combines ESDs in the linkage editor input 
into a composite ESD. Matching input symbols are resolved, and 
specified operations (replace, change, delete) are performed on 
the symbols. A renumbering table CRNT) is produced to allow 
input ESD IDs to be translated into CESD IDs. 


Exits: When ESD processing is completed, HENLFESD returns 
control to the routine from which it was entered (object module 
processor or load module processor). 


Text and RLD Processor~—HEWLFRAT (Chart CF) 


Entrance: HENLFRAT is entered from the object or load module 
processors when a text or RLD record is detected. 


Operation: HEWLFRAT determines record type (TXT or RLD), checks 
for error conditions Cinput record larger than buffer), and 
Passes control to the appropriate processor. 


Routines Called: Depending on the record type, HEWLFRAT passes 
control to either the text processor CHEWNLFTXT) or the RLD 
processor C(RLDOOL). 


Exits: When text and RLD processing is completed, HEWLFRAT 
returns control to the object or load module processor. 


Text Processor""HEWLFETXT (Chart CG) 


Entrance: HEWLFTXT is entered from the text and RLD processor 
when a text record is detected. 


Operations: HEWLFTXT operation depends on whether text input is 
from object or load modules. Object module text is moved from 
the object module buffer to the input text buffer, and must be 
arranged in the proper order. Load module text input is already 
ordered, so HEWLFTXT reads it directly into the input text 
buffer. In either case, the input text ID is renumbered to 
refer to the CESD ID of the appropriate control section. When 
veut text buffer becomes full, its contents are written on 


Routines Called: When the input text buffer is full, HENLFTXT 
calls the text write routine (TXTBUF—Chart CH) to write the 
buffer contents on SYSUT1. 


Exits: When text processing is completed, HENLFTXT returns 
control to the text and RLD processor. 


RLD Processor—"RLDOO1 (Chart CJ) 


Entrance: RLDOO] is entered from the text and RLD processor 
when an RLD record is detected. 


Operation: RLDOO] groups RLD items in the RLD buffer and 
renumbers the R and P pointers to refer to appropriate CESD 
entries. Each RLD item is processed according to its flag and 
address (FA) field. RLDOOIL also creates an RLD note list, with 
entries for each set of RLDs (a set being all RLDs having the 
same P pointer). If the RLD buffer becomes full, the contents 
2 the buffer are written on SYSUT1 and noted in the RLD note 
ist. 


Routines Called: When the RLD buffer is full, RLDOO] calls the 


RLD write routine (CRLDBUF—Chart CK) to write the buffer 
contents on SYSUT1, and an entry is made in the RLD note list. 
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Exits: When RLD processing is completed, RLDOOl] returns control 
to the text and RLD processor. 


End Processor""HEWLFEND (Chart CL) 


Entrance: HENLFEND is entered from the object or load module 
ee cee when an END record or the end of a load module is 
etected. 


Operation: HEWLFEND resets tables involved in input processing, 
processes entry point information, deletes CESD lines marked 
"chain”™ or "delete," and enters in the CESD the length of 
control sections for which no length was previously indicated. 


Routines Called: None. 


Exits: When end processing is completed, HEWLFEND returns 
control to the object or load module processor. 


CSECT Identification Record (IDR) Processor~"HEWLFIDR (Chart CQ) 


Entrance: HEWLFIDR is entered from the input processor, 
HEWLFINP, to process object module END records and load module 
identification records. It is also entered from HEWLFSCN for 
processing IDENTIFY control statements. 


Operation: HEWLFIDR takes IDR information from the input 
records and enters this data in the appropriate IDR table. 


Routines Called: Error and informative messages are processed 
by calling HEWLFLOG. 


Exits: When IDR processing ends, HEWLFIDR returns to the 
calling program. 


Control Statement Scanner~"HEWLFSCN (Chart CS) 


Entrance: HEWLFSCN is entered from the input processor when a 
control statement is detected. 


Operation: Depending on the type of control statement being 
processed, the control statement scanner makes entries in the 
APT, SEGTA1, and/or the CESD. This information is used to 
control subsequent linkage editor processing. 


Routines Called: HEWLFSCN calls the READ8 routine (Chart CT) to 
process control statement operands. 


Exits: When control statement processing is completed, HEWLFSCN 
passes control to the include processor (HEWLFINC) if an INCLUDE 
control statement was processed Cinclude chain built in the 
CESD). Otherwise, HEWLFSCN returns control to the input 
processor. 


Include Processor—"HEWLFING (Chart CU) 


Entrance: HEWLFINC is entered from the input processor when 
more includes®™ are indicated at end-of-input, and from the 
control statement scanner when an INCLUDE statement has been 
processed. 


Operation: HEWLFINC examines the include chain in the CESD and 
selects the next module to be included. It opens the data set, 
determines the attributes of the module to be included, and 
initializes the DCB to allow the module to be read. 


Routines Called: If a module for which the REPLACE/CHANGE 
function has been requested is not contained in the specified 
ee HENLFINC calls HEWLFEND to delete the corresponding 
C ines. 
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Exits: When include processing is completed, control is 
returned to the input processor. 


Automatic Library Call Processor-—HEWLCAUT (Chart CV) 


Entrance: HENLCAUT is entered from the input processor at the 
end of SYSLIN input, or when a NAME statement has been detected 
Cprovided that the NCAL option was not specified). 


Operation: HEWNLCAUT first scans the CESD for unresolved ERs 
specified on LIBRARY statements. It attempts to resolve these 
ERs by searching the PDS directories of ddnames included in 
library chains, allowing the members found to be read. A second 
CESD scan attempts to resolve ERs not specified on LIBRARY 
statements by attempting to call them from SYSLIB. 


Routines Called: After the first series of CESD scans, HENLCAUT 
returns control to the input processor to read the members. 


Exits: After the second series of CESD scans, HENWLCAUT passes 
control to the address assignment processor CHEWLFADA). 


INTERMEDIATE PROCESSING 


Address Assignment Processor—~-HEWLFADA (Chart DA) 


Intermediate Output 


Fntrance: HEWLFADA is entered from the input processor when 
input processing is completed 


Operation: HEWLFADA assigns linked addresses to all CESD 
entries, determines the size of SEGTAB if the program is in 
overlay, determines if the first text record does not begin at 
address 0, determines the number of ENTAB bytes required for 
each segment, builds the alias table, and determines an entry 
point for the program. 


Routines Called: HEWNLFADA calls the ENTAB size determination 
routine CHEHLFENS~—Chart DB) to compute the size of ENTAB, and 
calls the entry processor CHENLFENT—Chart DC) to build the 
alias table and determine an entry point. 





Exits: When address assignment processing is completed, 
THEMLEORy os control to the intermediate output processor 





Processor~“HEWLFOUT (Chart EA) 


Entrance: HEWLFOUT is entered from HEWLFADA when address 


assignment processing is complete. 


Operation: HEWLFOUT writes the following on SYSLMOD; CESD, 
SEGTAB (for programs in overlay), and scatter/translation 
records (for programs to be scatter loaded). If a HIARCHY 
statement is specified, storage hierarchy designations are 
included in the scatter/translation records. If the MAP option 
has been specified and the 2-byte table can contain all 
necessary entries, a module map is produced and written on 
SYSPRINT; if the XREF option is specified, and the 2-byte table 
can contain all necessary entries, and all RLDs are in storage, 
a cross-reference table and a module map are produced and 
written on SYSPRINT. 


HEWLFOUT builds the high ID table (HIID). The half ESD CHESD) 
is also built, after the CESD has been written. 


Routine Called: HEWLFOUT calls the MAP/XREF processor 
CHENLFMAP) to produce and write the module map and 
cross-reference table, if requested. 
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Exits: When intermediate output processing is completed, 
control is passed to the second pass processor CHEWLFSCD). 


SECOND_PASS PROCESSING 


Second Pass Processor~“HEWLFSCD (Chart FA) 


FINAL PROCESSING 


Entrance: HEWLFSCD is entered from HEWNLFOUT when intermediate 
output processing is completed. 


Operation: HEWLFSCD performs the following functions: 
e Reads text from SYSUTI 

° Relocates address constants contained in the text 
° Creates control/RLD records 


e Writes text and control/RLD records on SYSLMOD in a format 
that can be loaded by program fetch 


¢ Creates ENTABS and associated RLD items for overlay modules: 


Routines Called: During second pass processing, HEWLFSCD calls 
the following routines: 


e Control section search routine (CGETIDMUL—Chart FB) to 
determine the next ID and multiplicity to be processed 


® Text and RLD read routines CRDTXT, RDRLD-—Chart FC) to read 
required text and RLDs from SYSUT]I] 


8 Text write routine CWRTTXT—Chart RD) to write text on 
SYSLMOD CHEWNLMSIO) 


® Control/RLD record write routine CWRICRRLD) to write RLDs 
and control records on SYSLMOD CHEWLFSIO) 


® Second pass initialization routine CHEWLFREL—Chart FE) to 
initialize text and RLD control blocks 


® Relocation routine CRELOCATE-—-Chart FE) to relocate address 
constants (Cbranch-type and nonbranch-type) in the text 


6 Common path routine CHEWLCPTH) to determine common segments 
in an overlay path 


e ENTAB creation routine (SCDENTAB) to create ENTAB items for: - 
each segment 


Exits: When second pass processing is completed, control is 
passed to the final processor CHENLFFNL). 


Final Processors“HEWLFFNL (Chart GA) 


Entrance: HEWLFFNL is entered from HENLFSCD when second pass 
processing is completed. 


Operation: HENLFFNL performs the following "cleanup" functions: 
e Writes the TTR list for overlay modules on SYSLMOD 


e Places entries in the partitioned data set directory and 
issues a STOW macro instruction 


e Prints a directory of logged errors 
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Checks for more restrictive module attributes 


Produces a MAP and a cross-reference table if it was 
requested and not produced during intermediate processing, 
and if the primary or alternate 2-byte table will contain 
the needed entries. Warning message IEW0801 is issued if 
the alternate 2-byte table is too small. 


Routines Called: During final processing, HENLFFNL calls the 
following routines: 


Diagnostic message directory print routine CHENLFBTP), which 
scans the error logging map produced throughout linkage 
editor processing by the error logging routine 
CHEWLFLOG—Chart GC); HENLFBTP builds and prints a directory 
of error messages. 


MAP/XREF processor CHEWLFMAP—Chart EB), which produces a 
cross~reference table if it was not produced during 
intermediate processing. 


Exits: If end-of-file was not detected on a SYSLIN input, 





HEWLFFNL returns control to the initial processor CHEWLFINT), 
and linkage editor processing is repeated. Otherwise, linkage 
editor processing is terminated and control is returned to the 
control program. 


SYNAD Routine~"HEWLCRO1 (Chart GB) 


Entrance: The SYNAD routine may be entered from the following 
routines: 


From the control program when any input/output error has 
been detected 


From the second pass processor if an error is found after 
executing the XDAP macro instruction 


Operation: Following are SYNAD considerations for the linkage 
editor: 


The SYNAD fields of the DCBs in HEWLFROU contain the address 
of the appropriate SYNAD entry point for the access method 
used with the data set. 


If the SYNAD routine is entered from the input processor 
because of incorrect length, the length of the incorrect 
input block is checked. If a valid short block (integral 
multiple of CLRECL) is found, control is returned to the 
supervisor to continue processing; if not, processing is 
terminated with an error message and completion code of 16. 


If the SYNAD routine is entered while writing to the 
SYSPRINT data set, control is passed to the final processor, 
ee aaa is abnormally terminated with a condition code 
oO 


When the include processor opens the DCB for SYSLIB, the 
address of the appropriate SYNAD entry (for either BSAM or 
BPAM access methods) is moved into the SYNAD field. 


If the second pass processor finds an error after executing 
the XDAP macro instruction, it loads register 1 with the IOB 
address, loads register 15 with the SYNAD entry point for 
the EXCP macro instruction, and branches on register 15. 
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eno e001 *YES *NO(TYPE IS ER) eno e0] ° NO 601 © 
e 6 Jle¢ Oeee ® HIe e@ F2Qe 
eo @ ->¢ e e e@ 6 
e eJj3 ¢ 2 
e * 
eeee 
o*. 6. ESso15S -*. eve 
oF) ee F2 e, F3 2, Fa s, CeneerSsecocoesece 
. e * e, e e 
eis ESD TYPE®. -* IS CESD *. NO * IS CESD *. «*® IS CESD °¢. YES ®MARK CESO TYPE © 
*.CM, So, OR L Saree s. TYPE CM A oe >e, TYPE LR a Gown ° TYPE one e MATCHED e 
‘, | : _ Z F is . SITYPE ° ° 
e es. e? *,. 2? %, Pa Is cory od 6 
rn oe eons ¢. .¢ *. .¢ . et SOHSOESEOSOEOCESS 
*eYES e ° *YES YES eno is rs 
°* AQ @ cece ¢G3e ese 
¢ e ° e ry e =>¢01 °° 
eee6 e G3 e osee @ F2 @ 
e e-> e e 
coon eee 
ESD1? 28 COMMON 
Gi e, SHOCEGZ OC CESESEOS OOF OG JOS CCOHOEES SoveeGueesseoocces 
¢ e. SSPET CESD LENGTH® * DBLDE. ° * UPDATE’ LENGTH * 
e* [IS CESD *,. NO ° EQUAL TO ° 0.9 6_ 6_ 9-6. 9-66 © OF CESD ENTRY * 
¢, TYPE DELETE . *--- *°GREATER OF CESD® * DOUB LABEL °® ® TO GREATER e 
*. yee : AND ESD ITEMS *# : DEFINITION od : LENGTH * 
e. .¢ eens SOOCEHOHOSOSOEODE SOSSEEHHHESEETESE CHOOSE ESCOCE OO SEOEES 
*YES ° e 
oes e 65 °¢ see0e 
e e e e e e Lecnamennaa 
Hl ¢ ooee ¢ HR ¢ 
e e-> ° e-> 
eee0@ eve 
yvCESDDLNK % ESD1SA 
COSSOH]L OC OCeS TESS H2 e. CCRSOHJEsoooesece POOSST HSS OSE SEEECe 
¢ DLK e eo? e, ep ° oHEWLEPTH e 
Car ee ae See ee ee ee NO .®IS OVERLAY °. 0.06.0 6_6_ 0.8.8 et ee ee ee ee ee 
¢ OELINK CESD °¢ ---*, INDICATOR ON .* ---* CREATE A LINE *<-------- * FIND COMMON °¢ 
* LINE ® ®, IN APT .® *CHAINED TO LINE® ® PATH SEGMENT °® 
e e ° ¢FOR TCHNG SYM®*® e & 
OOO SOOCEHEHOCOOSSE eeeoe8 .e «® CHOOSES OSHOOHOHSSOCESOHE $0668 06060H86COOD 
02 ¢ *YES 0e02 ¢ 
eese ¢ g1¢ e Fie 
->e02 ¢@ ee ° ¢ 
e Ble e e 
® ® 
oece YES 
seveeszecoesooucs ESD16 RED *e. 
e ° 
6.6. 6. 6 6009 els ESD TYPE*. 
¢ FIND COMMON * -->*, DELETE ° 
¢ PATH SEGMENT ¢ | on i 
COSCO EOOOSHEHOOOHE eee *e. eo 
e ry *NO 
oes €eg3e eeee 
->¢02 ¢ ° e =>4¢Q] ¢ 
* Bi ® eeee oF 
e e 
e008 e008 
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CHART CF. 


TXT_AND RLD PROCESSOR (HEWLFRAT 3} 





FROM OBJECT 
OR LOAD MODULE 
PROCESSOR 


SoeeoHjeseoosecs 
e 


: HEWLFRAT 
CoH SEED OO OOOES 


v 
e 


® 6, 

eo e, 

*, END OF DATA . 
o, ® 


° 
eo, ? 


e, .e 
*Nno 


ro a 
J eo. 
.* INPUT COUNTS. 


2%, 
RATIN F2 e, OCOCOSFJ OC eC oOCOEOH 
=) e, oH GCA2®¢ 
e®INPUT SIZE *. YES Ont _ 020.00 080 
®. EXCEEDS RLO . ¢-------- >*® INPUT RECORD *<-------- 
*. BUPFE ° ; TOO LARGE . 
“eo. oo PSCHOSHOCHOKOSSEESEO SES 
ono 


POCEOG2 OFS SOSSOOS 
*RLOOO1 CJAL®e 
O29. 6. 9. 0. 0 LOL 8 
® PROCESS RLD °* 
. RECORDS ° 


O0STOCHHHOCOSTOOESES 


Vv 
OOOH Joooooveces 


RETURN 


OOOH SHCHSTHHROOSE 


YES 
@-------- 


ECPRG 
CCOOEE LOCO EHO DOES 


*KLDBUF CKAL® 
00806 0 


>¢* WRITE OUT RLD * 
. BUFFER 6 


SOHSCHSCHE SESE HHOOSD 


ooeoenuseeseseses 
*TXTBUF CHA3* 
O- 0-06. 00 60% 
* WRITE OUT TXT ¢ 
: BUFFER 4 
SCHOHOK ECL E ESCO EOE 


meee meee oe = a 


o%, 
Fa °. 
8 ®. 

« °INPUT SIZE °¢, 
*. EXCEEDS TXT .°® 
*. BUFFER .® 
e. .¢ 
*, .° 

*NO 


Sooo OGUSEOOOOEEOE 


we Ow Oe Fa Oe Oe Fe Ve 


29S OHOHOHHTEHEHE 


CeeoHSeeseccese 


RETURN 


COOH SOOCHHHEHE 
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CHART CG. TXT PROCESSOR (HEWLFTXT) 


pS ahh ne ee 


o%, o 
A} e, AY °, SOSeOoASseososesce 
Seoenlocsesocss -¢ *. -° *, eTXTEUF CHA3¢ 
e ® * *. YES »® ONE PASS °®. NO o— ¢. 9. O- . 0. H- OH 
4 HEWLFTXT O ee wee >®, END OF DATA . ®-------- >*, PROCESSING , %-------- >¢ WRITE OUT TXT © 
° ° ° .° °. .° ° BUFFER e 
9090094 HEHO8 °, .? e, -e 
*. ,e eo. ,% CHOKE HSS HOSOOS SECS 
NO *YES 
e000 
® ° 
¢ ps ¢ 
e o> 
ooee 
TXTLM ae .%, 
B2 B}. 
»-* ALL °*¢. ¢ *, $900R5 FOOSE SE 
YES .® ID-LENGTH °, YES .° *, ° 6 
---*, LIST ITEMS Tu. *<------<-- ®, LOAD MODULE .© == Swmaenmemnncencean > RETURN e 
¢, BE DELET-.¢ e rm J ® 
*, ED .* o. -* SOSH OHOCOOO SOOO 
eone *, .¢ *, ,°® A 
e ® eNO eNO 
e ps e 
e e 
0ose | 
TATKEAD o%, TXTOO011 o%. 
SOK LCCooeeeeeese C2 , re Me POSSE CHESCCHOOEOO 
be WILL °®%, *HEWLF LOG GCA2¢ 
e ® _ YES, e *RECORD FIT °. a 1s TXT 1D’ *, NO +. 9-60 6.0 0_6_8 
READ RECORD , elit AVAILABLE .¢ °; AN SD OR PC a) ewww ce== >® INVALID ID ON ®----------------- 
Ad A *, BUFFER aoe rae a . TXT CARD = 
®, e eo e 
OCOOCOH OH CEHOOOOS * ,~* e. 49 SOOHHHOHEETESOSOS 
*Nno *YES 


sev sepissscescoes 

® RENUMBER ID ® 
*UPDATE ERT Peo ® ° 

~~ > TABLE AND TEXT © b----- ®WRITE OUT TEXT ¢ ¢ 
NOTE LIST ® ° BUFFER * bd 

e e » e 

° 


: 
0069808600008 0098 


CHOOHEH2ZOC OST EOORe 


*TXTBUP CHAI* 
0000-0 0_0_% 


CoSFO DOK SEERE>OES 
¢ ° 

e 
RENUMBER ID ¢ 
e 
e 


SCHOKOSOHOHSCSCEO HOSES 0900008806069 H8 





TXTLM2 2%, 2%, [8° 
e, SoeerE2ececvecore £3 °. a ee PTITTIAT TILT TTY iy 
@ o. MOVE POLLOWING : ® e, *TXTBUF CHA3¢ 
-* 10 TO BE °*, YES ° ID°’S UP TO 7% °. ‘YES ° NEW ENTRY’ ®. YES #9092028 -6_4_8 
®, DELETED o Cee peewee aes DELETED® o. DELETE » &--- oe. CONTIGUOUS =) -e--— ®WRITE OUT TEXT © 
, «* ID *, ‘. s, 7% ® BUFPER e 
oe, @ bd bf e, * o, of . ¢ 
*, ~@ SOOOHHESOOO OE DOES *, .* enon *, ,.® OOO OFSOOOHHHOHOOO 
eto *NO ° 
* pS @ A 
° 
eee0 
Kaeewoan naw ee eee oe eww Bee ena =a = 
Vv see 
* TXTOOL 51 e 
Fl °. seve sb sevensseese Fu “ee. PTYTTITITI TTT i tit) 
°. ALCULATE © -° °. ° ° 
° MULTE SLIECITY 6 * PREV Evious *. NO ° ENTER NEW ® 
---9, ANY MORE ID°S, ®--- ® AND ° ~--->07 RECORD DENSE | « Veen ---->F RECORD « 
: . ) ¢ DISPLACEMENT ¢ ; ° ¢ 
oe, Pa e e i Pa 6 2 
. 48 eves Oooo eeEreoeesoere *, .° O00 SCS OOOO OO DODOS 
ry P ° 
® BS e osee 
° Pe >e ° 
ovee * BS ¢ 
° 
eeee 
TXTINT o*%, TXTO03B o®%, 
G3 e, G4 °, 
- *CURRENT®. e, 
~*ID AND MULT®*. YES NEW YES 
*. AGREE WITH .%--- =->¢, MULTIPLICITY, eoc= 
*. PREVIOUS .* ° } 
"oe, oe "eo, 6e oees 
®NO ®NO ° 
e KY oe 
° ° ° 
eoee8 ° BS ¢ 
>e 
cove 
TXTOO3) a 8, TXTOLD2 ,8, [" 
: 8 e, eoeeeySedecevecse 
.° "o, .° e. Ps ° 
; ao?” VIRTUAL % YES ¢ ENTEZRIN TXT ¢ 
* ‘ NEW ID 3 reece 2 2< ° STORAGE ‘ Phe seen eae a's a BUF PER b4 
*, .° °, .° e ° 
*, .¢ e, 4 Coooreovesscecere 
*YES *NO A 
TXTUEW o%. 
J3 °, Co Juceooccs 
: °. ° Ps 
«* LENGTH *. YES ® SET DENSE »® 
*, SPECIFIED IN .%----- e INDICATOR e 
*,. CESD Pad ° e 
e e 2 
"eo, Ve Ooesereoece 
ono 
oese 
e . 
* Ka e 
Pe > 
osee 
BUPALLOC 
ooK Jeeeeese COCOCKUOS SOC CDEOS CeoeeKSedscecoses 
° ® e Pf e ° 
*SET NO LENGTH®* ® ALLOCATE NEW *® ® RECORD IN TXT © 
e INDICATOR Oe ewe >* MULTIPLICITY e-------- >*® I/O TABLE AND °® 
e ® e e TEXT Ist ¢ 
° ° 
TeYTITI Titty seviseredoceeses Copeeeosoosesesos 
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CHART CH. TXT WRITE ROUTINE (ON SYSUT1) (TXTBUF) 


POCOAOOOSSOODS 

° 
: TXTBUP : 
Covocceecoosese 


B3 
.° 


SCOSSOHUSSSCOSOOO SES 


*e. ® CLEAN UP ° 


*. YES bd NECESSARY 


2? e 
®. END OP DATA .%-----~-~ >*PORTION OF TEXTe---.---- 
*. -@ e BUPPER ° 


TXTBUF1 -%. 
22> °. 


R ® RECORD PER 
UTI ¢@ascessus > TXT 1/0 TABLE 
e e ENTRY e 


° 
as COSC COCO OEOESOOE 


-* OVERLAY "* 
°.. SPECIFIED |.¢-~--- 


COC EGSSCSCCCCOOOCS 


908980800 OHH0008 


CODESHSecsoesooos 
o e 
POST LENGTH IP ¢ 

IN NO-LENGTH °¢ 
: SITUATION ® 
COSC OSOOOHESHOEOS 


CosecSeocovecces 
° 

RETURN : 
SOOT OOO OLOSOODS 


gleerEseeelesees 
® 
RETURN . 
Cooseovcesosece 


SeeseEseseeeleeys 
e 

®RECORD CURRENT ® 
e §6LEN e 
QBUFFER ADDRESS ; 
SCOKSHSEOTOOLSHOOE 


Trick eri) 
e 2 
INCREMENT TO ¢ 
NEXT TXT 1/0 
TABLE ENTRY ¢ 

® 


000006698 SOOO SSF 


o%, TXTBEND 2%. 
CO000H1 FF eeoesees H2 e, H3 o. 
ADD PRESENT ¢ of ®, 2% &, 
LENGTH TO 6 YES .® THIS MULT *. NO .®ALL TXT I/09. ® WRITE ANY » 
ACCUMULATED %<--------%, ONE LARGER . &<-~------*. TABLE ENTRIES. %-------- > ACCUMULATED 
LENGTA *. TAAN LAST. © *. WRITTEN . * e LENGTH e 


e «® * ® 
*,. .? *. .¢ Soosccoovecvoese 
eno ° 


| | 


7? 6, 
a et *. NO ° 
MULT 3 e 


SO NHQUSSOH OOOOH SE 


eeese 


9080009 OSOOSCOCCE 


Coo jJocoeooosooesse 
WRITE ad 
ACCUMULATED 
LENGTH bd 


0900000 SS0888098 


SOTSOKIOSOOOOOEES 
‘ ° 6 


.¢ ® 
ES .®*LAST ENTRY °. ® INCREMENT TO ® 

ee et *. HIGHEST MULT. O~-~—= m4 NEXT ENTRY Summ 
*e. 3° e Ps 
eo. -@ 90S CHOSE HSHOHHSEOOOHS 

e e @ 


°@ 73 ¢ 
e 
esee 
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CHART CJ. RLD PROCESSOR (RLDOO1) (PART 1 OF 2) 


Az’ “8, 
COeeAlerosesses -? eo. 
° ° .¢ *. YES 
: KLOOC] : merece near FROM EuDd o Oem nn nee 
POCOHHOOCOH OO OOS me. a 
*, .e@ 
*NU 
eeee 
eo1l ¢ 
® pPp2 e-> 
® e 
eoee 


sawepsecveeutees 
e 


® SET COUNTERS *¢ 
FOR NEXT RK AND * 
© P POINTERS : 

* 


e 
CHOOSE HHEOCOOS 


o%e 
c2 °. 
Pad ®. 
-*IS P OELETE*. YES 
° : IN RNT a Pr een 
“e, _ 
e, ,¢ 
*NO 
RLDOO 3 o%, 
©0000F] 800886808 2 4 
®RLDBUF CKA1 -° °. 
o_ 9. 6-6 8_0_0_9_% ® P SAME AS ¢ 
@ MAKE BUFFER %<-------- ®, PREVIOUS P_ ,%<----- 
e ENTRY ° . 
e ®, ? 
OOOOH SCOOESH HOES eo. .e 
*YES 
RLNOQOQUA Vv 
SHCHOHEZ OC oeeveses 
» 
®RENUMBER R AND * 
wee en enn ene neee >¢ P POINTERS = ¢ 
® ° 
SOSH OHHHHHOHOHE!S 


SOTCOF1] Ceres ecoese F2 °, 
*HEWLCDLK 6 -¢ *, 
0.0.60 00 9_0_¢ YES .° ° 
° O<ee------ *, DELINK .° 
e DELINK ° °. Cid 
° ° e, ¢ 
COCSHHHOEHOOC HOSES o. ot 

[ 

seceeaslscceesesaS tees > 
> y 


»® °,. 
«®RLO FLAGGED®. 
-->¢. AS BRANCH .* 
os TYPE ® 


ALL 
OCOOO TZ ECC OOESEO 
° 


® 
® SET ENTRY IN 
CALLS LIST 


e 
O©O9SFHOHHEEOOOODE 


SPOSOOKZEOC SOSH DOHS 
e 


e 
®UPDATE COUNTERS® 
--- FOR LH FA °° 


® e 
OOOOH OHSOCHS HOSES 
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aseoaece= 


® 
Peewee 
e 


RKuwwce 
e 


COOCHOA JOOS SCOR OCOD 


¢RLDBUP COO CAUSCC ORS OOCE 


o9-¢ F869 6.06.98 e eo 
-->® WRITE OUI RLD e-------- > RETURN ° 
é BUFFER ° ° ° 
° ° COCK COOH SOO OOS 


0088 OOOOH HH OHH 


69ST JOOCH OHO OOS 


e ° 
*SET DELETE FLAG* 
-->° AND SKIP RLD * 
® ITEM ¢ 


e * 
COSSHOHHHSHOHOH HOD 


RLDO10 0%. 
GY 
-* IS R 


-* _PSEUDO- 
Bees ces SSS ease scct cus cceoe >*. REGISTER IN .¢-------- 
¢, RNT 9 


e, e 
eno 


o*, 
HS e, 
-* 18 R_ @, 
YES .* EXTERNAL °, 
o----*, REFERENCE IN . @<------- 
¢, RNT o? 
°. -o 
*. ,¢ 
*Nno 


OOOCd JJESTeCooEDE OOPS THOVECLO FOS 
e ® 


*MULTDET 

$0.0 ¢_0_0_ 08-0 e FLAG RED POR °¢ 
-->¢ ESTABLISH Ok eee ee --= e RELATIVE 6 

: MULTIPLICITY : ; RELOCATION bd 


0980000880998 608 0406040060008 O808 


RLDO122 0%, 
K3 * 
YES .* IS RLD §* NO 
@---*, CONTINUATION . %--- 
¢,.FLAG SET .*® 
ie ere evoes 
° 002 ° 
e Bie 
oe 
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OOP LEG HhOeoesooore 
° 


® 

®FLAG RLD AS PR ® 
>e TYPE ° 

® 2 

e e 

S000 0OCSOO8SOSS 


IBM Corp. 1972,1985 


Contains Restricted Materials of IBM 
Licensed Materials ~~ Property of IBM 


CHART CJ. RLD PROCESSOR (RLDOO1) (PART 2 OF 


eo2 ¢ 
® Bl ee... 
e ? 
eee0 
RLDO1 3 ® ‘ 
a) *e. 
.° °. YES 
*. OELETE 2 @--- 
©, .° 
e, a) 
*. 8 
*ko 
wecwdecanicemodanessSaaaw > 
[ RLDO15 — 
Covvor Zobecoverseres C3 ° 
dere ter tas NO. ¢SUFFICIENT’ 
= 0. 6.6. $06.6. P °, 
* WRITE OUT RLD #<-----... e,  SPAC i 
e BUFFER ° *. BUFFER" .¢ 
e 
006860006 SHOHHEHHSE eo, oe 
oYES 
2%, 
COSC EHP ESC OOCCODE D3 *, 
° ° -? o, 
Pe e YES .*ID SAME AS *. 
¢ COMPRESS ¢C-22---== *.PREVIOUS ID'S. * 
e e *e. eo 
06066 OOOSSHOOHOHES eo. .% 
*RO 
SCOKOHE J SC OSSSSORS 
*MOVE RLD ITEMS ¢ 
iwiwciaaceosese >s TO BUFFER = ¢ 


6 t 
6960609884000 0008 


RLBO152 *, 
F3 °. 
® ® 


NO .° ALL ITEMS 6, 
~--*. | PROCESSED |: ¢<-- 


OOF OG JOS SCC OOES 
° 
Pe RETURN : 
Soeeoovecsecoseo 
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[i Gente oceeeeesweieeosweuee cewereeess veo sapes sou 
o%, ea e o%, 
A2 e, a3 e, aa *, 
CORAL OC CO CCCSS .° e. .e e, .° e. OoeeASeooccoocs 
® ® e, No ®@ 9%, YES ® , NO e ® 
: RLDBUP : eeeer—== >. ANY NEW RLDS .° eceecce= Pee. EOD ee" -——weacce 70 ANY RLDS LEFT. © eeeene== >e RETURN - 
PyyTYTYYIT Titi ii) *e. o “ee, eo *e. .o Oococcesccseces 
e, .% eo. .~®  ~¢ 
YES *YES 
RLDBUF1 0%. 
B2 e 
o® e, 
.® , KO 
¢. LOAD MODULE, .¢-=- euewealucewe oe 
a eo 
e, .e 
*YES 
| rr 
o*, 0%, RLDOBUP 3 o%, a%, 
Sesecciestsessoee c me 2 o. ot ee. cs o. 
® GCA2Z¢ e e e ° e 
oHEMEE LOS . SCO<> YES .¢ OVER ¢, &O °° BUFFER “*. NO -® NOTE LIST ©. NO e - NO 
° @¢-2------0, MAXIMUM SIZE .¢-------- >*, OVERFLOW . ¢-.~------ >*. FULL ( Veewawe=— >e, EOD ee 
® ERROR ROUTINE ¢ %, o® 4, «® e e e, * 
e ® e. ® e ¢, e e Ld 2° o. ° e 
TTI yYiiriiiiiiit) o, .e o. ,¢ o, .¢ e, .e 
® YES ®YES *YES 
oece 1 oes 
® ° ->6 ° 
¢ p2 ¢ * D2 
6 on ° ° 
oece eee 
RLDBUPGA o%, RLDBUF2ZA .°%. 
TTT yi D3 e, oS . 
OOSON1 Cocereres e ° x’ o, 6 e, 
e e @ SET TWO PASS °¢ YES .®° 2 BUPPERS °. YES .¢ 
¢ RETURN ° rs PLAG CCacaeueee °: FULL ae e; TWO PASS :°® 
e ° @ ° . | ‘ °. 4 
PYyITIITIViIi tt ° ® e, .e ®, .° 
Seoeoocesecsscecs o. .° e. fe 
eKO eno 
.%, 
rYIIIy yiti tr iiiit) E3 : 
Ps ® .° *, OoeeEgocoosoece 
@ FORMAT NOTE °*® YES .*¢ ®. NO Ad e 
; LIST ENTRIES s* eceeree- e bod on eae >e RETURN : 
e ® "e. eo SOSDOOSOSELECCS 
SOSOREHOEOOSOROOS e. .° 
° 
RLDOBUP6 «%, 
F2° “9, CoocePpgcococococs ovenepSeccccecese 
r e. e e e ° 
.*ANY BUPPER’*, NO *MAKE NOTE LIST * ¢ SET IN-CORE ¢ 
>, WRITTEN | .¢-------------------------------<-->¢ ENTRY $fessceo Ue ‘ DATA Sén0 
"eo. oo e e ° ° 
*, .° Coesscosesoorooecs PYYTITYLITIiT itis, 
*YES 
RLDBUP? o%. 
SoeeeGZeOSerereere G . PoeGSeoesoccsssere 
*COMCHR ° ° :. 
$20. 0 0. 02 02 Fe O80 e « YES id ° 
ecunhewaceinaan >OCHECK/NOTE LAST¢---~----- ~~~ oe o-oo --- e. LIST FULL (t-ece----> WRITE LIST 
ad WRI 6 ° e ¢ 
°. .* 
Covesessoocsocors e, .8 Coececcoceoseoes 
eng 
YES 
os s o%, RLOBUFTA o®. 
Hi e. COON 2SO CH OES9OOR 3 e, HS . 
o® e i @ e, Pid eo, 
e@ ¢ ® e NO .* 2 BUFFERS ¢, YES .* 2 BUPFERS °*°, 
e. EOO A ee ee WRITE BUFFER <-------- e; “WRITTEN .¢<-------- e. FULL ee 
». * e e e, * *, a) 
o. .e ®, : ¢, .° 
*, ,e OOooeeereoooooce *. .° o, .e 
; *YES ® 
Coney Jeccccececs 
td] 
is Cay a Ot SP a a a ee OE ome ce coe ce eae eeeanee re @aa2 2 ee acececece=>6 RETURN * aa eee ea vaura es @ee 
Coocvcccseoross 
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CHART CL. 


oooh] Seeceveceo 


° e 
° HEWLFEND ® 
e e 


ON IN APT. ¢ 


-® T e. 

YES .®ENTRY POINT® 
BIT 

® 
e 


Dl “e. 

° e, 

NO .¢ IS ENTRY ‘®. 

<-- 9. TYPE ABSOLUTE. * 
“e, e 2 


* eYes 


ENDO} 
COOOL] OOOCOODEOOS 


®RENUMBER THE ID® 


OOOCOF] OCS OO COO ES 
e 


® 
*SET ENTRY POINT® 
bd BIT ON IN APT ; 


t 2 
9OFHHHOSSHEHHOHED 


ais 5 cn at el So > 
END1 .¢, 
® *e, 
-* IS NO. *, NO 
*. LENGTH BIT ON, ¢--- 
*. IN APT .¢ ] 
e ? 
e. .e oooe 
*YES ° ° 
* AJ e 
6 e 
ee00 
o%, 
H1 e SCovoeH2oeseooccece 
-¢ ° ° LOG  GCA2¢ 
-° IS LENGTH *, NO o-6_6_0_0_¢_0-0 8 
®.GIVEN IN END .®-------- >*NO LENGTH GIVEN® 
*, RECORD .°® ® POR CONTRCL °® 
°, .° ° SECTION ° 
e,. 8 090800088 OS 80808 
eYES 
Le cesecccccscecdaesenscsas 
ENDIA 


CORSO TL OOOO LO OOE®D 


E s 
SECTION : 
9090088680888 e 


COT OOK SHOE EOOEO®O 
: TURN OFF ‘NO 


® 

LE ° 

® INDICATOR IN ¢ 

° APT ° 

e 

scebnceauvesevecs 
ooee 

->¢ ° 

az ° 

e e 


eee 


END PROCESSOR (CHEWLFEND ) 


oee0 
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CHART CS. CONTROL STATEMENT SCANNER (HEWLFSCN) (PART 2 OF 2) 
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CHART CU. INCLUDE PROCESSOR (HEWLFINC) 
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AUTOMATIC LIBRARY CALL PROCESSOR (CHEWLCAUT) (PART 2 OF 2) 
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CHART DA. ADDRESS ASSIGNMENT PROCESSOR (HEWLFADA) 
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CHART DB. ENTAB SIZE DETERMINATION ROUTINE CHEWLFENS ) 


FROM ADDRESS 
SIGNMENT PROCESSOR 
SOSOCA ZO COC OOCOD 


e o 
e HEWLFENS . 


6 
06099008008 408080 


ENSOoO070 
SOOSEOHZ 6 ee vssesoe 


6 ® 
@ SCAN CESD FOR : 
: REPERENCES ° 


® 
OCFSOTFHHOOHHHOOCE 


C$OOCSOEHCZeCessOoESe 
®USING ID OF ID ®@ 
¢ LENGTH PIELD, © 
REFER TO SD OR @ 
e PC ENTRY IN ¢ 


® 
COSCO SCOCHSHOHSEROS 


COSSOH2OC CE 9ESOCE 
ry e 


INSERT SEG NO. ® 
sae CESD FOR LR ‘ 


e ¢ 
OS3S 0006900008008 


o %e 
E2 e 
a ® e, 
.s °. NO 
e. in OVERLAY Pd wee me em we wet ee ee SC Oes ees ew we mew mem eer eee eeeese 


i e 
o, .° 


*, .? 
YES 

COCCOPJ[E0O SC LCCCEE 

e e 


®SCAN CALL LIST ® 
*ENTERING CHAIN ¢ 
° POINTERS * 


CHSCOCHSCOOCO ESCO EOOOS 


ENSO15 0%, 
G2 ° 


. SCOBHEG I OOO SS OCOSO 
2° ANY ¢, ¢ BEWLY GCA2¢ 
«*CALLS FROM ®, NO @n0_6_0_6_0..6~ 6.0 
*,.SEG NO. 1 TO , ¢-------- >¢ PROGRAM IS ® 
*. ANY OTHER, & ® EXECUTABLE ON °® 
*. SEG .® ®LET OPTION ONLY® 
*, 9% OOS OHSSHHSOHHSCOHOS 
YES 
en 
PE Pi 
}-4 » 


e 
SOSKSHHHHCOEHEOOD 


OOOOOTZ00CC+OESE 
e e 
o—0_0_ 0. 0. 0.0.0.8 


* MAKE ONE CESD ¢ 


*ENTRY FOR ENTABS? 
¢ PER SEGMENT ® 
CESS OOOO SO OEOOES 


SOSCOKAOSSECOEOS 


wt eae ieee nen aes eam nua aaeaee >e RETURN e 
OOO 8OOSSOOCSSS 


TO ADDRESS 
ASSIGHMENT 
PROCESSOR 


128 MVS/XA Linkage Editor Logic LY26-3963-0 © Copyright IBM Corp. 1972,1985 


Contains Restricted Materials of IBM 
Licensed Materials ~~ Property of IBM 


CHART DC. ENTRY PROCESSOR (HEWLFENT) (PART 1 OF 2) 
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CHART DC. ENTRY PROCESSOR (HEWLFENT) (PART 2 OF 2) 
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RETURN 
Svoeoovecsesooe 


Program 


Organization 


080601 SOeoeneens 
e e 
*UPDATE TO NEXT *® 
bd RLD ITEM : 


e e 
00006 00000008 SO88 


POOCOE) OS OCC CEESS 


° 
UPDATE LOW ° 
MULT. IF IN &< 

HIGHER MULT. : 


OOOH OHHH HEOOES 
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CoeoA Zee esesece 
° ° 
° HEWLFREL bd 
e ° 


0000600608068 


RELOCATE 
CooeeH20¢es0000008 


*CALCULATE ADDR. ® 


90008600 HOHHO898 


COCR OCZECCECOSOESO 
° ° 


*SAVE R POINTER, ® 
¢ UPDATE TO PA ‘® 
e FIELD . 
966066009996 HO88 
e606 
e01 © 
* D2 e-> 
e ® 
e000 

o®, 


D2 %. 
2® *, 
«*END OF RLD ¢, 
EXTENT 


E2 °¢, 


2% e, 
NO .*RLD WITHIN ¢. 
onaeenee %e TEXT LIMITS .¢ 


e, .° 
*YES 


OOCOe PZ OC Ce eEEOSE 
® a 
*DETERMINE ADCON* 
: LENGTH : 


e e 
COOK OSH FOOSOHOHOSE 


« ADCON. ge" 


RELOC20 o% 
H2 ° 
Pid o, 


o® e, 
*. SPLIT ADCON .° 


YES $00.60 0_0_0_ 


RELOC150 
OOCOOHJOSSESSEORES 


° Sear Low ° 
YES *MULTIPLICITY OR® 
¢ MAR ° 


K ENTR 
; * PROCESSED* ; 
SOOOK SOOO SSCS EOSS 


OOO OG JOS SLOSS OOS 
*ERROR ° 


YES O60. 06.0.6. 0_% 


OOOOH FOS eoeesees 
*SPLTADCN 


SPLIT _ADCON 
ROUTINE 


OOS 00 SOSSOSCHEEEHS 


aeoeaane 


Cssececescesceesessescscce 


RELOC60 0%. 
J2 *. 


e® eo. 
-® ADCON e. 
*. REQUIRES .* 
*. DE INKING, ¢ 


.¢ 
NO 


al 


e 
K2. °®. 
® e. 
.*fS THIS AN °. 
° Y¥ 
*, MODULE .° 
@ e 


*, .° 
*YES 


CCeoOTZI ON CSoOSEDE 
® OBTAIN DELINK * 
AND 


YES e VALUE 


RECT R 
® POINTER FOR 
RELOCATION 
COCO OSOS OSES SOES 


2 
eeeoe 


NO 


esece 

°02 ¢ 

* Ail® 
6 6 
bY 


MVS/7XA Linkage Editor Logic 


Contains Restricted Materials of IBM 
Licensed Materials — Property of IBM 


CHART FE. RELOCATION ROUTINE (HEWLFREL) (PART 1 OF 3) 


LY26~-3963-0 © Copyright IBM Corp. 


YES YES 
po’ “es, DS “e, 
oo oe, a Lr 
.®MORE NEEDED®, NO .*NEEDED RLDS®. 
ae >. RLDS IN GROUP. ®-------->e. IN OTHER .® 
° .° ¢, BUFFER .¢ 
e, Pa e, Pa 
eo, .% eo, »~® 
° a) 
COOSESS CCCOH SIE 
6 e 
° RETURN ° 
0006S 8H OSSOSESD 
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CHART FE. RELOCATION ROUTINE (HEWLFREL) (PART 2 OF 3) 


eeo8e 
#02 6 
°® Al® 


RELOCTS 
COCCOAL OOOO SOOOOE 
e 


° 

®MOVE ADCON FROM? 
® TEXT TO WORK ® 
: REGISTER 4 


COCSHOHHHSCHHHHOEOE 


o%. RELOC130_ .®, 
Bi e. B2 °,. Ooo oeAzecooosooos 
hd °. «* °, ® INSERT e 
-*°IS RLD TYPE*. NO -*IS RLD TYPE*. YES ® CUMULATIVE PR * 
*., RELATIVE o Q--ennnn->%, PR TYPE 2 .¢-------->* LEN INTO ¢--- 
° -° *, -® *VALUE OF ADCON ® 
e, .° e. ? e ® 
e,. .e . ef? OOOO OCHS OOOOO ESE 
eYES *NO 
Loc e %, o%, 
oe ae 1 e, c2 °, SoeoeCjesoveceses 
~*IS HESD*. % eo, e e 
o*% E Y FORK *®,. NO -*°IS RLD TYPE®. YES *ADD OR SUBTRACT® 
#. ADCON KED .°%--- wee DELINK ae” -------- >° DELINK VALUE . 
eo. e e oe 
e, » e, «® e e 
e. .° *. .¢e POCHOEOOEEHOSOOEE 
° ° 
YES NO ccae 
->e * 
°* El ¢ 
e ® 
oees 
o*, 
D2 %. 


COoCOH]L Sserencece 
® e 
¢ MAKE ITA ° 
¢  FOUR-BYTE  ¢ 
eNEGATIVE NUMBER® 
OOOOH SHHHHSHOS 


one 

CHOHOEL OOS SS OSORO- 
° PERFORM ° 
®RELOCATION: ADD® 
¢ OR SUBTRACT ° 
* RELOC. FACTOR : 


6 
0000966060888 OO88 


RELOC100 v 
COCCOEL OC ereroeee 
° 


° 
*MOVE RELOCATED * 
*ADCON BACK INTO® 
: TEXT RECORD . 


C$OCCCHHOHESEOORSSE 
eoeoe 

e002 e 

® Gl %-> 

e e 

oene 

OOF OG1 SOOO OOH 


» 
RELOCATE ° 
ADDRESS FIELD *° 
OF RLD ITEM : 
COKER OOCDEDEOECS 


eteeven 


.* °. 
«*IS RLD TYPE*®. YES 
*., ABSOLUTE .°%--- 


eo. o® 
e e ° 
*. .° oees 
enc s 2 
* Fl 6 
® s 
0930 


SSTOOE ISS SH OCOOSE 


*°TYPE IS BRANCH ° 
* OR PR TYPE 1, ° 
*INSERT ABSOLUTE® 
eREL. PACTOR FOR® 


H1 *, PORE HZO SOS OOCCED 
e e, e e 
-° *,. YES * SAVE RLD ITEM °* 
¢. SPLIT ADCON . ® moor ence sis HESO PREFIX : 
"eo. ss ° e 
* .? COCR OSES OOSOEOD 
*NOo 
cove 
02 ¢@ 
°* 71 | 
e e < enw eee wee eee eeeee e222 eee 
oees 
RELOC120 
OCCOOTLOOSOSSESOe 
® ° 
®UPDATE TO NEXT ¢ 
: RLD IT : 


e 
0000008608899 68H80 


ose 
->eOl ¢ 
* D2 °e 
e & 
e008 
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CHART FE. RELOCATION ROUTINE (HEWLFREL) (PART 3 OF 3) 





SCDOVLY .° 
A e, 
o@ e, 
-° 15 ITA ®, 
*.V-TYPE ADCON . ¢--- 
es fae 
° .° eee0e80 
oYES e02 6 
| ® Ale 
e*°¢ 
e 
*. 
Ble, 
=< *ER 
.~*IS ADCON'S ©, No 
©. LENGTH FOUR , ¢-------- 
*., BYTES |. 
“eo, oo 
| 
Vv 
o % 
cl e, 
-°1S THE *. 
-* ADcONTS ¢. YES 
». SYMBOL UN- ,¢--- 
*. RESOLVED .¢ } 
“oe. oo eeece 
*NnO 02 ¢ 
® Ale 
6 @ 
e 


SCHOOH] OPC E OOS 
e e 
COBTAIN SEGMENT © 


MBER OP ® 
SCALLED SEGMENT b 


COCO OHHH ODEOOKHS 


COOKE L COSC CR OOEE 
° ° 
SOBTAIN eh ade : 
sCALLING SESMENT® 
SOOTHHHHOOOOSEODE 


Seceepiases eaves 


* HEWLCPTH e 
oo 8. 6.6. 0n 8a Oot. 0 
* FIND COMMON ¢ 

SEG, WITH ¢ 
HIGHEST SES NO. ¢ 





e °, 
id S IT.A_ ¢, YES 
*. DOWNARD CALL. 


OVLY10 ° 


@ AN e, YES 


*, ALLOWABLE . ¢---------.~--~---- 


* eo. EXCLUSIVE.© 
®.CALL .° 


°. ld 
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OOOOH ZO00 FOROS 
R 


9 Were cme wenn nsecoeen 
A 


Ce ee ee ee ee ee 


>*SET BIT MAP TO ¢--- 
QREFLECT AEVanto: 


69900 OSSOOHHHHHHOEHEOH 


°02 ¢ 
® Jie 
e 6 
® 
OVLY79 oo. 
or © 4. 
YES .*ENTRY LIST °, 
eoe*, ENTRY FOR. 
*. THES Ip .® 
"e, .o 
[ 
ar oecoHucoseeceses 
oe °. *HEWLFLOG  GCA2¢e 
e*ENTKY LIST ©. YES o~ 0.60.0. 6..6— 6.6 
peseteeutinn ° FULL teco------>¢ ENTRY LIST  ° 
. id : OVER LFOW . 
Tg oo Ooo oereocnrenoroe 
*Nno 
OVLY9O 
Seocejsjocceoeoces 
e ° 
® CREATE NEW ° 
ENTRY IN ENTRY * 
e LIST 


® 
O9OSOOTHEHHHCOOES 


COOK IOC OH HESOOE 


ciwnscdcanneccecee >*POINT TO ENTAB ® 
® ENTRY ; 


OCOSCHHHOESOOO DOCS 


Editor Logic 


CooeHSeceecs cos 


RETURN 
0000908 00600008 
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CHART GA. 


aiectie ANT ERM OINE 


FINAL PROCESSOR (HEWLFFENL ) 


OR SECOND PASS PROCESSOR 


COOCAZ EC COEOOEEE 
° © 
. HEWLFFNL ° 
e ° 


OOS SOHCHOOEEOOS 


o%, FNL100 
p2. 8, CooDsecescccccecs 09000 B4C08000 0000s 
: PLACE TTR OF °@ 
*OVLY OPTION®. YES ® WRITE TTR e QVERLAY TTR * 
. ECTIFI 2 Bene m= > LIST FOR eeernce pe ost IN POS °* 
= ." ° . OIRECTORY : 
eo. eo 000860 OF CHHBEECO 0906060066060 O888 
NO 
ee eeeeee @2 ee eee ew ee er ee SS SQ eenenwnesraerw== 
Tritriritr Titi i) Coovecjesososesos 
© PLACE MEMBER ° ° SET UP C-BYTE ¢ 
NAME IN POS. * ¢ OF DIRECTORY ° 
*DIRECTOR G2ececese ° rf ° 
¢ NAME CARD ren ° $ BLOCK/SCATTER $ 
C8 OCS OOH SCOEOESHOD OSCSHSCHHSCHOHHESOOOS 
HERLELOG ae Fo 
Meat ATE 
FNLIOLA %., 
Sop2ececese D3’ “* SeeeeHusesecsooss 
® STOW e 7% . @HEWLFLOG GCA2® 
® DIRECTOR e o® °*. YES 0. 0. 0~6—6_0_ 9.9.8 
® WITH ADD OR %-------- >*®, ANY ERRORS . ®------~ ->°10G ERROR TYPE ® 
® REPLACE ° ve a : AND MESSAGE °® 
geanectcees "eo, we PrTyryyYiiiiririiy, 
ehO 
eee88 | 
° ° 
® E2 ¢ 
e Sew <€ See 2 See eee ena 2 DO 6 ee ee ee oe ee aeee =a ee eee nn=ass® Seoaanew 
coos 
PNL9SOOA o%, FNL9I 00 e%, 
E2° “e, CORSE JOccceeeeee a” “ee, CCCoeESeceoocoseos 
2? s, e SAVE MAIN ° e RENT OR®*, ® SAVE MAIN 6 
elto Be stodep 1° tes >on ENTHE POINT. Oe >elATTRIBUTES ON.* > eR 
*e. o ¢ PUT IN ALIAS °¢ *e. : © DIRECTORY AND 
e. .° ° Ps e, .° e Re 
°, .¢ PTT yi irri iiits e, .e decccecsoccoeseee 
@No *KO 
see 
° 
¢ F2 6 
oeee 
FNLCN %, 
F2. 8, COOCOPIOOSCSOCCCe COCCCPQSO CO SOOSES 
«* HAVE @¢. SPRINT IMAGE TO @ ; pick UP ALIAS ® 
e °ATTRIBUTES ©. YES NOTIFY OF ® Ee * 
®,. CHANGED SINCE. *-------- >e CHANG d *DEFINED OR USE ¢ 
©. START OF .® ® ATTRIBUTES ° MAIN BE. PP.) °® 
*®,EDIT .¢ ° ® ® 
e. .e Perri T ti ritiiiit PrryTTiitiririii yt 
e 
oeee aes 
r ° ENTRY FROM 
e Gi °*® HEWLPINP TO : 
® e-~ TERMINATE Cdmededcadewseeteoeou sees 
oeve ¥ 
e*, FNLCN2 o% 
Gi **, G26, eeGnesecces 
-® e, o@ e. *STOW ALIAS ° 
e *HAS IT BEEN*. YES o® XREP « YES ° IN ® 
e. DONE oe Ce wene *, SPECIPIED .%--- ® PARTITIONED *¢ 
e, 2° e e DATA SET 
° o® e, . DIRECTOR 
°. .8 oe... 000 eooeosecses 
*NO eNO e e 
¢ Gi 
wencoacoes > e ° 
Co0g 
IEWLCEO!I .*. o%, 
COCCOHi seecececes Sesscuzscesoesess Hd) te Hs : secssipcecesseese 
e Ld o o e » 
en sy ) sad fa = = i sees >a i ped ade °,. ‘ YES 0.0.6.8.0. 9.8208 
° esates --->® GOTO PRINT ¢-------- >e, END OF INPUT .¢--- ¢. ANY ERRORS |= ¢-------->®10G ERROR TYPE ° 
¢ PRODUCE XREF ¢ ¢ DIAGNOSTIC * a oe .° AND MESSAGE 
Co ooecoveseeseoes TIYIsIiritiiiitie, "oe. fe "eo. oe Odesecoseosscorecs 
*NO NO 
eee 
ry ° 
ee P2 @ 
pee ne (ivaneasanweeswaoess ° ° 
eoee 
PNLIQGA 
eoJZesecece CoTJEsoooss Pry rerriirii tii tl 
® ® e eo 
¢ REPOSITION *. ° ° * GO TO PRINT @ 
e ERMEDIATE ® ®CLOSE ALL PILES*¢<-- *ALIA 
oFILE (SYSUT1) © a ® » MESSAGE e 
"eheeseceoes” ‘eeesesonoce PTITIT Ti iiiiri its 
| soee 
->e r 
°¢ £2 ¢ 
° e 
Pry) 
CooseKJoscoseoere 
CoceKZeccccoses ° s « rYYt) citi i itite) 
RETURN TO * *CONDITION CODE ® ® RETURN TO ® 
¢ INITIALIZER ° ¢ INDICATING IF ®-------.-------.-~ Sdeesuweacece -==>® CALLZR ° 
2 ° e NEXT STEP IS ¢ Ps 
Coeerecocoresor ° Cossveeseseoecs 
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PROM BSAM 
0%, 2%, -%, %, 
A2 ¢, gee s, AS e, AS ®, 
OOOOAL CORES OOOO * e, S TRIS® x) eo, a) 
o ® IS THIS °*, NO oPRoM SYSLINe. YES * Is IT *. ¥ 2 *IS VAL . X 
® HEWLCRO1 Ceeeee--- >e, FROM SYSPRINT, %------ -->6) Pee ate IB .e ooe---e- >. INCORRECT si hs ----- >6, Pe oat en a ze 
° e », Pe XED . ar °, LENGTH o® e hd 
Cooeoscesesesss e, .e 4 : Z .e ®, .8 
® e e e e, a ? e » e e, e ® 
YES *NO ono ono 
\_ eso | | 
>e e 
eK ¢ 
e » Leow Seu BP wewzwewwreuewew oe Sete 22 ewes ee eee ee es eee Se ew ee eenoneaenuc 
Coe 
SOoSe AIFS Seesse00 
® e oeeeHSeceseocos 
* SYNADAF MACRO ¢ e e 
. FOR BSAM bd - RETURN Ss2 
6 ® OO0FCOCOSHSSOOO 
OC8OSO COTES ECOEOE EEO 
eo00 
=->¢ r 
¢ PZ e 
® e 
FROM BPAM eevee 
SeoeeCjIessosocoss 
SHSOC2O0OCOOEES s e 
® * ® SYNADAF MACRO ¢ 
: HEWLCRO2 coremene ree FOR BPAM e 
COC SOFC HEOOOS ® e 
0000008 S9SSOS9OOO 
s e » 
2? ee ersee Dace seaesees 
SET BIT e 
, oENTRY, FROM’ ®, otes : apehROn WORE : 
ane . oe Cncwece = OR War VE os 
eoce "eo, agen pesaceecenesesees 
e e 
e PP} e 
e ° 
se00 
FROM XDAP 
SSeeVEs?eereeesee 
SCHOLZ OO COC ESED e 
° ® : SYNADAE BACKS e 
e HEWLCRO3 @-~--_ 22> e 
° e ® e 
8000009600 00008 ° e 
0000800008808 008 
eee 
e e 
° F3 e 
cece 
MESGPNTA .*, 
rad deal fd tad F3 e, SOOOH PRESSE OSORCS 
® INSERT ® o* *. 6 INSET e 
* *JEWO IN ®* ® ERROR e, NO ® "TEWO29%° IN °@ 
MSG, SET BIT IN¢<~-------®, READIN @ Meme wwe-->*MSG, SET BIT INP 
®APT phok BIT MAP® ¢. SYSLMOD .* *APT FOR BIT MAP? 
° PROCESSOR ° e, 6 ® PROCESSOR 6 
SOSCHHSSOSOHHOOHOS e. ,@ OCOOHCHOSOSESEOOOS 
® 
Qa es eS eS es ese SOO SF OS2 ea Bee awwe Rowen wee ee eee een owe ww eceoere 
SSOKOEGISOOOSOSOSCS 
® e 
®°MOVE MESSAGE TO® 
° PRINT BUFFER : 
e 
wissecesscnsioees 
SCHOCOHHJ OSS S&OOCEDS 
* HEWLEPNT 6 
O60 6.9.9 t_6_8 
e e 
. PRINT MESSAGE . 
0000608 0000000000 
COSCO TIOCSSEOCSORS 
° * 
® e 
¢SYNADRLS MACRO : 
e e 
OO0FF 0808 SSSCHOOD 
oo00 
e e 
® Ka e 
° oe. 
eeee 
s ® e 
C$OSHOKZ OC ORS COTES K3 e, 
COSCKL OOse0RN00 ® TURN OPP BIT °¢ ? e, seeoKgeoseceosos 
* RETURN TO e @ INDICATING e YES .°* ERROR ¢, NO ® EXIT TO FINAL * 
o MAP/XREF 0¢-------- ® ERROR WHILE ¢<----+-~+ @, READING e O-=--— Seat ed TO ABORT ® 
® SREADING SYSLMOD® ¢, SYSLMOD .® e ° 
SeeoseCoesoOoee e ® e, .? CO0SCOCOCOE CESS 
coseesoooovvecees e, .? 
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CHART GC. ERROR LOGGING ROUTINE (CHEWLFLOG ) 





OSCR AZ CO COSSSEER 


° 
b4 KEWLFLOG : 
Sooo rerooeeceeS 


SSOCOH 200 00CC CRE 


®SEPARATE ERROR ° 
° CODE AND ° 
s MESSAGE NUMBER . 


LOGO} LOGO7 2%. 
CHOC] OSeroeeeooe C2 e 
.® e, 
¢ RITE OUT ° YES .® CONTROL °*. 
CARD IMAGE Reoeeenece *., STATEMENT TO .¢ 
s e *. BE LISTED. * 
COOOHO HO OEECOECO i rr 
°no 
°, 
D2 ¢. 
C0 0Of] COoeseoce a) 
° ° « *CESD SYMBOL*. NO 
° RETURN e *.TO BE WRITTEN. *--- 
2 e o, OUT ~? 
COOKS SOOO DOOOE ® e 


COOLS EZ CO FE OO LEOS 
® ® 
*MOVE SYMBOL TO * 
SMESSAGE BUFFER . 


® e 
0049 9OOSOSHHHOCOO 


Pa 
F2 *. 
2° e, 
e*°IS THERE A ©. NO 
*- SECOND SYMBOL. °--> 
er _e 
oe. ,®8 
*YES 


C$OSKEGZ OOOO BEEOEE 
® ) 
¢ MOVE SECOND °¢ 
° ¥ To» 
sMESSAGE BUFFER . 


LOG10 
OOOH ZS OSbOEdORS 


® WRITE OUT e 
@ MESSAGE BUPFER | 


COSCO SOOHH OHHH DD 


pee agaecsesasess 
° 


UPDATE 


0 
e 
e 
e ° 
*CONDITION COOE i 


e ° 
COSOSCCHHSCOTESESESS 


GAG2 o%, 


COCK] C80 e8 e008 are me ig: OOOOK 0000060080 
@ YES .° *. NO * 
° HEWLFFNL C<ennnnnne *- SEVERITY CODE. ¢------—- > RETURN ° 
C$OO6 OOOO 88S 0080 *e. .o 0300690000999 08 
*, .e 
e 
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MICROFICHE DIRECTORY 


The microfiche directory, Figure 33, is designed to help you 
find named areas of code in the program listing, which is on 
microfiche. Microfiche cards are filed in alphameric order by 
object module name. If you wish to locate a control section or 
entry point on microfiche, find the name in. column one and note 
the associated CSECT name. A description of the control section 
is also given. 


This section also contains a module-CSECT cross-reference table 
(see Figure 34 on page 19493. 


Entry point HEWL FROU See HENLEPNT 


Label HEWLFROU Open exit list for HENLFINT, HEWLFINC 
SYSLIN, SYSPRINT, and 
SYSLIB 

HEWLFROU Open exit list for HENLFINT, HEWLFMAP 
SYSLMOD 
Entry point HEWLFAPT SYNAD exit routine for 
: SYSPRINT 
Entry point HEWLFSIO Routine to check reads HENLFREL 
on SYSUT1 

Entry point HEWLFSIO Routine to check writes HEWLFREL 

on SYSLMOD 


APTEND 
APTEXLST 


APTXLIST 


APTO000 


CHECKRD 


CHECKWRT 


ENQNAME 


Label HENLFROU Major name by which HENLFINT, HEWLFFNL 
SYSLMOD is enqueued 
Entry point HEWLFSCD Text LOOK AHEAD/READ HEWLFREL 
| AHEAD routine 


GETIDMUL 





HEWLCADA 
HEWLCAD1 


Entry point HEWLFADA Routine to make CESD -HEWLFENS 
| entries for ENTABS | 
Entry point HEWLFINC Automatic library call HEWLFINP 
processing 


Entry point HEWLFRCG Library DECHAIN routine HENLFESD 


HENLCAUT 


HEWLCDCN 
HEWLCDLK 
HEWLCEOD 


Entry point HENLFINP DELINK routine HEWLFESD, HEWLFRAT 


Entry point HEWLFINP even routine for HENLFINC, HEWLFROU 


Entry point | HENLFFNL ae HENLEROU 


Entry point HEWLFESD Return point to avoid HEWLFRCG 
ESD processing 


Entry point | HEWLFFNL HEWL FROU 


Entry point HEWLFFNL Immediate termination HEWLFINP, HEWLFROU 
processing 


HEWLCEOI 
HEWLCE30 


HENLCFAB 
HEWLCFNI 


Figure 33 (Part 1 of 4). Microfiche Directory 
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HEWLCICA Label HEWLFINP Pointer to include 
processor 

HEWLCIDR Entry point HEWLFIDR IDR user data from HEWLFSCN 
IDENTIFY statement 
processor 

HEWLCINP Entry point HEWLFINP See HEWLFINP HEWLFTXT 


HEWLCMDB Label HENLFROU 


DCB for SYSLMOD HEWNLFFNL, 


HEWLFINT, 
HEWLFMAP, 
HEWLFOUT, 
HEWLFSIO, HEWLFSYM 


HEWLFAPT, 


HEWLFROU | DCB for SYSPRINT | 
HEWLFFNL, HEWLFINT 


HEWLFRCG HEWLFESD its 
HEWLFRCG | 










HEWLCPDB Label 






HEWLCPTH 
HEWLCRBB 
HEWLCRBN 
HEWLCRID 


Entry point 
Label 
Label 


Label HENLFESD ESD ID of item 


currently in process 


END-OF-DATA routine for 
SYSUT1; SYNAD routine 


HEWLCRO1 Entry point HEWLFROU 


HEWLFINC 


for SYSUT1, SYSPRINT, 
and SYSLIN 





HEWLCRO2 Entry point 


HEWLCROS Entry point 


HEWLFROU END-OF-DATA routine for | HENLFINC | 
SYSLMOD | 

HEWLFROU I70 ERROR routine for HEWLFSIO 
SYSLMOD , 


HENLCSDB Label 


HENLFROU DCB for SYSLIN -HEWLFAPT, ©. . 
HEMLFFNL, HEWLFINT 
HEWLFFNL Termination processing HEWL FROU 
after SYNAD exit : 


HEWLCSNX Entry point 


HEWLCTTY Label 


HENLFESD Type flags for current HENLFRCG | | 
ESD item 


HEWLFFNL, 
HEMLFINT, 


HEWLCUDB Label HEWLFROU 


HENLFINP END-OF-DATA routine for 
SYSLIN 
HENLFINT Reentry into HEWLFROU, HEWLFFNL 





DCB for SYSUTI1 





HEWLFOUT, 
HEWLFRAT, HEWLFSIO 





HEWNLEEON Entry point 


HEWLENAM Entry point 
initialization for 
multiple link-edits 
HEWL EPNT 


HEWLFROU SYSPRINT OUTPUT routine | HENLFBTP, 


HENLFFNL, 


Entry point 


HEWLFINT, 
HEMLFMAP, HEWLFOPT 


HEWLFINP PRIMARY INPUT READ HEWLFTXT 
routine 


Microfiche Directory 





HENLERDM Entry point 


“Ti 
= 
Fe | 
¢ 
“% 
it?) 
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Type CSECT Description Referenced By 
CSECT HEWLFADA Address assignment HEWLFINC, 
. HENLFINP, HENLFROU 


Entry point HENLFROU TABLE ALLOCATION HEWLFAPT 
routine 

CSECT HEWNLFAPT All Purpose Table 
CCommunications Area) 


Entry point HEWLFMAP RECOVERY routine after HEWLFROU 
SYNAD exit 


HEWLFADA 


HEWLFALK 


HEWLFAPT HEWLFINT 


HENLFAPX 


HENLFBTP CSECT HEWLFBTP Error message printing HENLFFNL 
HEWLFDEF CSECT HEWLFDEF Default size values HEWLFINT, 
HENLFOPT, HEWLFOUT 
HEWLFEND CSECT HEWLFEND End record processing HENLFINC, HENLFINP 
HEWLFENS CSECT HENLFENS ENTAB size HEWLFADA 
determination 
HEWLFENT CSECT HENLFENT Entry statement HEWLFADA 
processing 
HEWLFESD CSECT HEWLFESD ESD record processing HENLFINP 
HEWLFFNL CSECT HENLFFNL Final processing HEWLFOUT, 
HENLFROU, 
HENLFSCD, HENLFADA 


HEWLFIDR 
HEWLFINC 


HEWLFINP 
HENLFINP, HEWLFSCN 


CSECT HENLFIDR IDR record processing 


CSECT HENLFINC Include statement 
processing 
CSECT HENLFINP Input processing HENLFINC, 
| HENLFINT, HEMNLFROU 


CSECT HEWLFINT Initialization HEWLFROU 


Label HEWLFROU DCB for SYSLIB HENLFAPT, 
HEWLFFNL. 
HENLFINC, HEWLFADA 


Entry point ERROR LOGGING routine HEWLFAPT 

 CSECT MAP/ CROSS-REFERENCE HEWLFFNL, 
processing HEWLFOUT, HEWLFROU 

CSECT Options processing HEWLFINT 

CSECT Intermediate output HEWLFADA 


CSECT HEWLFRAT RLD record processing HEWLFINC, 
HENLFINP, HENLFSCN 
CSECT HENLFRCG REPLACE/CHANGE HENLFESD 
statement processing 

CSECT HEWLFREL Relocation/second pass 
initialization 

CSECT HEWLFROU Miscellaneous 
routines/LOAD module 
entry point 


Figure 33 (Part 3 of 4). Microfiche Directory 


HEWLFINP 


HEWLFINT 
HEWLFLDB 


HEWLFLOG 
HEWLFMAP 


HEWLFOPT 
HENL FOUT 
HEWLFRAT 


HEWLFRCG 


HEWLFREL HEWLFSCD 


HEWLFROU 
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Symbol Type CSECT Description 
HEWLFSCD CSECT HEWLFSCD Second pass (LOAD 
module) output 
CSECT HEWLFSCN Control statement 
processing 
HENLFSIO CSECT HEWNLFSCD Second pass 
input/output 


HEWLFSYM CSECT HEWLFSYM SYM record processing 
HEWL FTXT CSECT HEWLFRAT TXT record processing 
HEWLTMDB Label HEWLFROU DCB for SYSTERM 


HENLXIT2 Entry point HEWLFINT Open exit routine for 
SYSLMOD 
HENVLDCK Entry point HEWLFROU Member and alias name 
validity check routine 
Label HEWLFROU DDNAME for primary 
input data set 
INRLDCB1 Label HEWLFREL ee RLD control block 


INRLDCB2 Label HEWLFREL orue RLD control block 
JFCBADDR Label HEWLFMAP JFCB for SYSLMOD 


MAINGOT Label HENLFINT Address of storage 

obtained from GETMAIN 
Label Minor name by which 

SYSHOD is enqueued 

MSGFOUR Label Pointer to Coptional) 
heading message 

OTRLDCB1 Label HEWLFREL Output RLD control 
block #1 

OTRLDCB2 Label HEWLFREL Output RLD control 
block #2 

OTRLDCB3 Label HEWLFREL Output RLD control 
block #3 

RELOCATE Entry point HEWLFREL Address constant 
relocation routine 

SCDENTAB Entry point HEWLFREL Routine to create HEWLFSCD 
ENTABS and ENTAB RLDs 

SEGLNTAB Label HEWLFADA Pointer to Segment HEWLFOUT 
Length Table 


HRTCRRLD Entry point HENLFSIO Routine to write CTL or 
CTL/“RLD records on 
SYSLMOD 

WRITXT Entry point HENLFSIO Routine to write text HENLFREL 
records on SYSLMOD 


Figure 33 (Part 4 of 4). Microfiche Directory 


Referenced By 
HEWLFOUT, HEWLFROU 


HEWLFINP 


HEWLFSCN 





HEWLFSCD 





-HEWLFSYM 
HEWLFRAT 
HEWLFFNL, HEWLFINT 
HEWLFROU 


HEWLFFNL, HEWLFSCN 
HEWLFINT, HEWLFSCN 
HEWLFSCD 
HEWLFSCD 


HEWLFFNL 


HEWLFFNL, HEWLFINT 


HEWLFROU 


HEWLFINT HEWLFROU 





HEWLFSCD 


HEWLFSCD 


HEWLFSCD 


HEWLFSCD 


HEWLFREL 
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Module Name CSECT Name 


















HEWLFADA HEWLFADA 
HEWLFAPT HENLFAPT 
HEWLFBTP HEWLFBTP 
HEWLFDEF HEMLFDEF 





HEWLFEND HEWLFEND 
HEWLFENS HEWLFENS 
HEWLFENT HEWLFENT 


HEWLFESD HEWL FESD 
HEWLFFNL HEWLFFNL 
HEWLFIDR HEWLFIDR 
HEWLFINC HEWLFINC 


HEWLFINP HEWLFINP 
HEWLFOPT HEWLFOPT 

















































HEWL FMAP HEWL FMAP 
HEWLFINT HENLFINT 
HENLFOUT HEML FOUT 


HENLFRAT 
HEWLFRCG 
HEWLFREL HENLFREL 


HEWL FROU HEWLFROU 


HENLFSCD HEWLFSCD, HEWLFSIO 
HEWLFSCN HEWLFSCN 


HEWLFSYM HEWLFSYM 


Figure 34. Module/CSECT Cross-Reference Table 


HEWLFRAT, HEWLFTXT 
HEWLFRCG 












150 MVS/XA Linkage Editor Logic LY26-3963-0 © Copyright IBM Corp. 1972,1985 


Contains Restricted Materials of IBh 
Licensed Materials —— Property of IBM 


TABLE LAYOUTS 


This section provides detailed layouts of internal tables used 
during Linkage Editor processing. Figure 35 indicates the 
modules in which tables are initialized and used or modified. 
Tables described in this section are included alphabetically 
except for the All-Purpose Table (see Figure 36 on page 152). 


HEWLFESD 


Used and/or Modified by 
HEMLFFNL 


HEMILFENS 


HEWLFRAT, HEWLFSCN, HEWLFINC, 
HEHLFADA, HENLFENS, HEWLFENT, 


Composite External Symbol 


Dactionary (CCESD) 
HEMLFOUT, HEWLFTXT 





HENLFRAT, HENLFSCD 


TTR Last CText I70 Control HEWLFSCD 
Table) 


Fagure 35. Table Construction and Usage 





HEWLFSCD 


HEWLFOUT 
HEWLFOUT 
HEWLFOUT 
HENLFOUT, HEWLFADA 
HEWLFOUT, HEWLFSCD 
HEWLFRAT, HEWLFTXT 


HEWLFOUT, HEWLFSCD 


HEWLFSCD 





HEWLFOUT, HEWLFSCD 


HENLFOUT, HEWLFSCD 
HEWLFSCD 
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Notes to Figure 35: 


1 Major communications area throughout linkage editor 
processing. 


2 Built and processed entirely within one routine. 


Offset 


Decimal Length Description 


PDSEl Member or alias name of module being created 


Relative disk address (TTR) of first record 
of module 


h— 
oO 


NO -_ 
o;}™ Bo) ve) 


Flags 

Bit 0 Alias indicator 

Bits 1-2 Number of TTRs in user data 

Bits 3-7 Length of user data in half words 


Relative disk address (TTR) of first text 


PDSE4 — 
record of module 


— 
oo 


— 
WG 


Relative disk address (TTR) of note list or 
scatter/translation record , 


N 


Number of TTRs in note list, if present 
Flags (module attributes #1) 

Bit 0 Reenterable 

Bit l Reusable 

Bit 2 Overlay 

Bit 3 Test 

Bit 4 Only loadable 

Bit 5 Block/scatter format 

Bit 6 Executable 


N 


1 


© 


PDSE7 


Bit 7 ia contains 1 text record and no 
Ss 


Flags (module attributes #1) 


Bit 0 Output load module not downward 
compatible 


PDSE8 


Bit l Origin of first text record is zero 


Bit 2 Entry point assigned by linkage 
editor is 


Bit 3 Module contains no RLD items 


Bit 4G Module can be reprocessed by linkage 
editor 


Bit 5 Module does not contain SYM records 


Bit 6 Module was created by link editor F 


—_ 


“TI 
2 
io 
Cc 
“% 
1) 
WG 
ON 
o~ 
“~ 
1) 
ba | 
fam 
—_ 
°o 
“h 
p— 
So 
~~ 
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Offset 


Decimal Description 


Bit 7 Refreshable 


Length 


WN 


WG i 


Total contiguous storage requirement for load 
module 


N) 
4 


PDSE10 
PDSE11 
PDSE12 


Length of first text record 
35 Entry point address 

Editor assigned origin of first text record 
Flags (1) (Module attributes #2) 


Bit 0 Load module built by OS/VS linkage 
editor 


Bit 1 Not used 


Oo. 
re 


Bit 2 Page alignment required for load 
module 


Bit 3 SSI present in directory entry 


Bit 4 Directory entry contains 
authorization code 


Flags €2) (Module attributes #2) 
Bits 0-2 Not used 


nN 
~J 


oO | 09 WNIiW N - 
Orel arta dl = rm 


Bit 3 Load module residence mode 
Bits 4-5 Alias entry point addressing mode 
Bits 6-7 Main entry point addressing mode 


Count of RLD and CTL/RLD records following 
the first text recor : 


=] 


Number of bytes in scatter list 
PDSE14 
PDSE1L5 
PDSE16 


Number of bytes in the Translation Table 


ESDID of the first text record 


~J 
Tl 


ESDID of the control section containing the 
entry poin 


Oo 


PDSE17 
PDSE18 


Entry point of main member name | 


Member name of module 


WG 


Register save area for data management 


13 I/70 Control Table 


N 


IOCT 
APTO 
Bit 0 NCAL 
Bit 1 XREF 
Bit 2 MAP 
Bit 3 LET 


pu ~ — im 
™ 
ce 
a. 


“Tl 
wi 
a 
Cc 
> | 
1) 
WG 
ON 
~ 
“~ 
Y 
ej 
ce 
N 
© 
= 
fant 
| 
—_ 


All-Purpose Table CAPT) 


LY26-3963-0 © Copyright IBM Corp. 1972,1985 Table Layouts 153 


Offset 
Decimal 


Length Symbol Description 


Bit 4 LOG 


Bit 6 TXT/RLD 


TEEPE 
r 
HO 
n° 
23 
Ss et 
oo 
O H- 
a3 
Wi 
= 
9 
e+ 
OW 
3 et 
pl. “3 
0) 
me 
© 
|2 
= 
"0 ® 
3 et 
Oo 
G 3 
: = DH 
30 
| €&6 
oo 
: chh 
I 4 
| | . ty Og 
= | | ae 


Bit 7 A library statement was read 


157 APT1 Flags 


oe 

PAPT. 

| | Bit 0 More include input to come — 
aa Bit 1 Automatic library call in operation 
| | Bat 2 Object or load module 

| ss | Bit 3 Delete indicator 


Bit 4 Entry point received 


a Bit 5 Symbolic or absolute entry 
ae Bit 6 Entry statement received 


APT2 


Bit 7 ESD write indicator | 
Flags 

Bit 0 No length received 
Bit 1 No length indication 
Bit 2 First text record 


Bit 3 Status indicator received 


- Bit 4 Include previously initiated 
Bit 5. I70 overlap bit 


Bit 6 In module indicator. 


Bit 7 Card continuation 


t 
. 
a: a, 2 ‘ 


_ 


5 


ve) 


APT3 Flags 


Bit 0 End of file 


Bit l Name statement received; end of oe 
input for load module 


Bit 2 End of SYSLIN input 

Bit 3 To stow as replacement 
Bit 4 First text of load module 
Bit 5 First text of segment 

Bit 6 RLDs for group 

Bit 7 SYSLIB opened 


160 CTTR Relative disk address (TTR) of first CESD 
record, if MAP or SREF option specified 
Figure 36 (Part 3 of 10) All-Purpose Table CAPT) 
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B4 RCCB 


ALCB 


Address of replace/change chain beginning 


p— 
oo 
B=) 
Le =] 
098 


Offset ay 

Decimal Length Description 

164 AG Current segment number 

166 Current region number 

/ 168 Pseudo register cumulative length 

172 AC Address of first deleted CESD entry 

176 Address of replace/change chain end 
| RccB 
PALCB 


Address of alias chain beginning 


ua 
oOo 
oO 
os 


OVCMBGAD| Address of overlap chain beginning 
SGT1 Address of SEGTAB1 ~- 1 

CLLT Address of Calls List Table 

RLDINPAD| Address of RLD input buffer, lst pass 


RECNT Address of Relocation Constant Table - 4; 
Renumbering Table - G4 


Address of Text I/0 Table 
Address of Alias Table 
Address of DELINK Table - 5 
Address of composite ESD - 16 


— 
wo 
N 


oO 
iN 


—) re _ mn wo =] 
Oro So © oO & @] 
© OO} D = 


Co 


N 
oo 


0 C 
204 CC 


a 


FXTIO 
ALAS 
DLKT 
CHESD 
SELST 
TNLS2 


216 


224 Address of second pass entry list 
Address of text note list 2 

RNLS2 Address of RLD note list 2 

TTRLIST Address of TTR list 

RLDOUTBF] Address of output RLD buffer, 2nd pass 
HIARADD | 
ORDRADR 
INCBRKPT 
CRRTINCL 
ENRNX 
ENCDX 
ENT2X 
ENR2X 
ENTOX 
ENCLX 
ENDTX 


N 
oo 
mM 
=) 


EC 
Fr 


Se 


N 
wo) 
< 
Ti 
a=) 


N N 
=) 
low] 


Address of Hierarchy Table 
Address of Order Table 


mn 


8 
Address of breaking point in include chain 


256 Address of currently included ESD item 


Maximum number of entries in RNT Table 
Maximum number of entries in C/HESD Tables 
Maximum number of entries in text note list 2 


Maximum number of entries in RLD note list 2 


ND) 


68 
270 | 


Maximum number of bytes in Text I/0 Table 


Maximum number of bytes in calls list 


Maximum number of entries in DELINK Table 


N 
~ 
N) 
~~ 


m1 
=) 
Fa | 
Cc 
i | 
@ 
WG 
ON 
o~ 
ar 
0) 
> | 
re 
A = \ 
© 
=~, 
_ 
& 
ww 
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wi 


5 


— 
oo 


offset 

Decimal Length 

274 ENS1X 
276 114 BUFSIZ 


284 


288 


GN 
© 
ff 


WG 


0 


1 


paul 
-—_ 
©) 


ENELTX 


IDRTRLEN 
IDRTILEN 
IDRUDLEN 


IDRTRTAB 
IDRTITAB 
IDRUDTAB 
IDRZPTAB 
IDRTREND 


2 


Ww 


3 


iN 


ee ee ~ 
N pa 
o;1o } © tT 


316 13C IDRTIEND 
316 13C IDRTIEND 
320 140 eo IDRUDEND 
324 144 ima IDRZPEND 
332 14C 4 LSTS 
Tso [ase [Pence 
358 166 sf ENELTC 

Figure 36 (Part 5 of 10) 
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Description 

Maximum number of segments 

Size of load module input buffer 
Address of HESD Table - 8 


Maximum number of entries in 2nd pass entry 
is 


i 
ce 


Maximum length of IDR Translator Data Table 
Maximum length of IDR Translator ID Table 
Maximum length of IDR User Data Table 

Maximum length of IDR AMASPZAP Data Table 
Starting address of IDR Translator Data Table 
Starting address of IDR Translator ID Table 
Starting address of IDR User Data Table 
Starting address of IDR AMASPZAP Data Table ' 


Address of next available byte in IDR 
Translator Data Table 


Address of next available byte in IDR 
ranslator ID Table 


—| 
gue 


Address of next available byte in IDR 
Translator ID Table 


Address of next available byte in IDR User 
Data Table 


Address of next available byte in IDR 
AMASPZAP Data Table 


Maximum size of input RLD buffer, lst pass — 
Save area 

Last segment in each region Cregion 1-4) 
Entry point symbol or end card address/symbol 
Current number of bytes in TXT I/0 Table 
Current number of bytes in calls list 
Current number of entries in SEGTAB1 

Current number of entries in Alias Table 
Current number of entries in DELINK Table 
Current number of entries in RNT Table 
Current number of entries in H/CESD Table 


Current number of entries in 2nd pass entry © 
is 


j= 
ct 
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able 


Licensed Materials ~~ Property of IBM 
Offset ae . 
Decimal Length Symbol Description 
ENT2C Current number of entries in TXT note list 2 
| 3620 16A ENR2C Current number of entries in RLD note list 2 
364 16C ENSPC Highest segment number with text 
368 170 IDRTRCUR[ Current number of bytes in IDR Translator 
Data Table 
372 174 IDRTICUR| Current number of bytes in IDR Translator ID 
Table 
376 178 IDRUDCUR| Current number of bytes in IDR User Data 
Table 
17C IDRZPCUR ree number of bytes in IDR AMASPZAP Data 


ORDRCUR 
ORDRMAX 
BITMAP 


Current number of bytes in Order Table 


— | 
oi~ 
© ; mt 


Maximum number of bytes in Order Table 


388 184 


Bit switches denoting error messages logged 
Cerror msgs 64-1) 


INVOKER 





Bit switches denoting error messages logged 
Cerror msgs 128-65 


18C BITMAP2 


~J 
N 


404 LINECNT 
HISEV 


SYSRTN 


Number of lines output for current page 
Highest severity message logged 


Save oc for registers 13 and 14 from 


Pe de oe oe ~ 
TI mr mm \o 
OoOrnatr oa»lha;|!l & §N 


416 
4 


SPACES Register save area 
Address of HEWLFLOG, error logging routine 


Address of HEWNLFALK, table allocation routine 


oo 
09 


E 
SI 
FFCADR 
LIBNAME 
LIBOPEN 
APT000 
SAVATS 
APTSWS 


System status indicator (for APT) 
F Highest address retained from gotten storage 
Name of library for automatic library call 
Name of library currently open 
SYNAD routine for SYSPRINT data set 
Attributes save area 

Switches 

Bit 0 TSO task 

Bit 1 Not used 

Bit 2 Absolute/relocatable 


Bit 3 DCBS override : 


Bit 4 Bit map processed 


“Ti 
pt 
a 
os 
> | 
@ 
WG 
On 
~~ 
“—~ 
o 
b> } 
ce 
On 
°o 
= 
_ 
fm) 
iw 
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Offset 
Decimal 


Length Description 
Bit 5 Linkage editor input received 
Bit 6 SYM received 
Bit 7 ESD received 
Flags 
Bit 0 If off, indicates Ist time in INT 


Bit l MAP/XREF entered from 
intermediate/ final processor © 





Bit 2 All RLDs in storage/not in storage 
Bit 3 MAP/XREF in control/not in control 


Bit 4 Normal printing on SYSPRINT/ABORT 
without printing 


Bit 5 HIERARCHY 
Bit 6 Not used 


Po. Bit 7 Indicates purge to TXT/RLD processor 
NEHISH2 Flags 


Bit 0 More RLDs exist for current ID 
Bit l Split RLD in output buffer 








527 





Bit 2 R and P pointer have been saved 


Bit 3 Relative/absolute relocation factor 
needed | 


N 
—j 
nm 


Bit 4 Split RLD has been saved in HESD 


prefix 

Bit 5 No RLDs exist for last text of 
segment/module 

Bit 6 Split RLD is preceded by R and P 
pointers 


Bit 7 R and P pointers for current chain 
are in buffer 


528 APTSW2 Flags 

Bit 0 SYSLMOD enqueued 
Bit 1 Not used 

Bit 2 SYSLMOD shared DASD 


Bit 3 First/not first time through 
initialization 


Bits 4-7 Not used 


1 APTSW3 Flags 
Bit 0 Expand statement encountered 


All-Purpose Table CAPT) 
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Offset ee | | 
Decimal Length Description 


Bit l Included load module was in overlay 
format 


Bits 2-7 Reserved 


APTSWNG switches 


Flags 
Bits 0-2 Not used 


N 
od 
N 


531 


N 
ro 
Ww 


Bit 3 Last IDR item processed not complete 


Bit 4 Double IDR entry on object module | 
record in process 


Bit 5 Identify control card in process’. 


Bit 6 Object module end card in process 
for IDR input 


Bit 7 Load module IDR in process 


Ut 
WG 
On N 


N 7 NM 
~~ 
© | © 


APT4 
Bit 0 First text record has been read 
Bit 1 Not used 
Bit 2 Intermediate pass processing 


Bit 3 Second pass processing 


ee Rit G@ . Onderine- required 


Bit 5 Page boundary alignment required 
Bit 6 Align on 2K-byte page boundary 
Bit 7 Not used 


MAXBF Maximum blocking factor 
HENLCRBB| SYSLIB control block 


Address of SYSLIB DECB 
lst library buffer 


a 2nd library buffer 


i 
WG 


4 2 


Wi 
_— 
oN 


3 
53 


On 
_ 


5) 
iN 
es) 


548 BLKSIZE 

LRECL 
el BLKFCTR 
aaa Number of records left in buffer 
Pe Address of current record 
aa 
HEL: 


22Cc 
560 


wi 
ON 
a) 


234 


READSH set to first read 
EWLCRBN 


SYSLIN control block 
Figure 36 (Part 8 of 10). All-Purpose Table CAPT) 
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Offset ™ 
Decimal Length | Symbol Description 
564 234 Address of SYSLIN DECB 
(568 | 238 lst SYSLIN buffer 
572 23C 2nd SYSLIN buffer 
576 240 BLKSIZE 
578 242 LRECL 
244 BLKFCTR 
2496 Number of records left in buffer 


Address of current record 
READSW set to first read 
SYSPRINT control block 
: Address of SYSPRINT DCB 

— Ist SYSPRINT buffer 
2nd SYSPRINT buffer 
BLKSIZE 
LRECL 
BLKFCTR 


588 24C 
HEWLCWBB 


25 


iN 


ON 
y=) 


0 


N 
Wi 
7) 


608 


Number of records left in buffer 
612 


RO 
Oo 
Bo) 


Address of current record 

WRITESW set to first write 
Address of first RLD output buffer, Ist pass 
Address of first RLD input buffer, 2nd pass 


RLDOUTI 
RLDINBF1 
RLDOUT2 
RLDINBF2 


- 


26C 


Address of second RLD output buffer, lst pass 


N\ 
ON 
7 


624 


wm) 


Address of second RLD input buffer, 2nd pass 
TXTBFBEG| Address of start of text buffer 

TXTBFEND| Address of end of text buffer 

MULTSIZE} Size of SYSLMOD multiplicity or record 
UTISIZE | Size of SYSUT1 record 

SZSYSUTI1 
RLDSIZE 
VALUE] 
VALUE2 


ON 
RO 


3 


NO 
~ 


N | NO 
“| ~N 
© fo i) 


WN) 


7 


2] 


Maximum number of bytes per track on SYSUT1 
288 
8 


Size of each input RLD buffer, Ist pass 


AD 


Size value 1 (maximum allowable storage) 
Size value 2 Cload module buffer) 


294 Pointer to Ist heading message 


MSGTWO Pointer to 2nd heading message 


“Ti 
he! 
© 
om 
be j 
te] 
WG 
ON 
on 
ba 8 | 
bw | 
re 
wo 
ie] 
=h 
—_ 
to] 
—_ 
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[tength | symnor | peseription 
4 | wsorinée| Pointer to rd heading message id 
reo fi tec for svn 
reo [id eee for syste SS 
a 
a 
rae 














[WODEAWOB| Addressing node fron node control statenent | 
[nODERHOD] Residence node from node control ctatenent | 


Figure 36 (Part 10 of 10). All-Purpose Table CAPT) . 





Alias Table 


Built by Entry Processor 
Referred to by Final Processor 


CESD entry number - present only if symbol is-one that is present in the CESD and is type 
SD or LR. This field contains zero for all other symbols (2 bytes). 





Symbol - the eight-character alias name (8 bytes) 
Figure 37. Alias Table 
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Calls List 
As built by RLD Processor 


a ee Ae 
7 


2 bytes of binary zeros 

Relocation pointer - points to the referred to symbol in the CESD (types SD, LR, ER, WX, 
and CM) (2 bytes) 

Relocation pointer (2 bytes) 








Relocation pointer (2 bytes) 


Position pointer = points to SD or PC in CESD that contains the references (V-type address constants) (2 bytes) 


Figure 38. Calls List (CAs Built by RLD Processor) 








Calls List 
As altered and used by ENTAB Size Determination Routine (HEWLFENS) 









2 bytes of binary zeros 
(End of chain indicator) 


Chaining value - inserted by HEWLFENS -~ count, in bytes, to next chaining value (2 bytes) 


Figure 39. Calls List (CAs Altered and Used by ENTAB Size Determination Routine) 
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Composite External Symbol Dictionary (CESD) - Internal Format 





Built by ESD Processor and Control Statement Processors 
Modified by Address Assignment Processor 


por foe pasar | TT ET SSE TST 


Chain pointer/chain ID/length - chain pointer when the entry 





type is: ER-Include w/pointer or on ER-ddnome 
that was extracted from o LIBRARY control statement 


chain 1D when the entry type is: 


ER-Library (the symbol was extracted from o LIBRARY control statement) 


length of contro! section for type: 


SD, PC, PR, or CM (2 bytes) 


Subtype - ER 
ER-Control change 


ER-Control replace 
ER-Control delete 


ER-Control include w/ pointer 


ER=-Control include w/o pointer 


ER-ddname 
ER-Alias 
ER-Overlay 


ER-Unmotched library member 
ER-Matched library member 
ER-Unmatched no call 


ER=-Metched no coll 
ER-Never call 
ER-Delete 
ER~Replace 

(1 byte) 


If segment number, 1 to 255 (SD, CM, PC, LR? 


If AMODE/RMODE/RSECT data (SO. 
MMMM. not used 
.-R... RSECT information 
O = not read-only 
1 = read-only 
gthete CGA RMODE gata 
0-24 
1= ANY 
eke eh eae AA AMODE data 
00, 01 = 24 
10 = 31 
11 = ANY 


Alignment factor {PR} 
07 = doubleword 
03 = fullword 
01 = halfword 
00 = byte 


Chain oddress/reverse chain ID - used to create a chain of CESD entries (3 bytes) 


Type - Section definition (SD) 
ara Label reference (LR) 
Private code (PC) 
Common (CM) 
Pseudo register (PR) 
Null 
Externol reference (ER) 
Weak external reference (WX) 
(1 byte) 


Symbol - the eight-character symbolic name (8 bytes) 


PC): 


XXXX 
XXXX 
XXKK 
AXKX 
XXX 
0000 
AXAX 
XXX 


Figure 40. Composite External Symbol 
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0000 
001} 
0100 
0101 
0110 
Onl) 
0010 
1010 


Hex 
0000 0000 00 
1111 0000 = FO 
1110 0000 = £0 
1110 1000 E8 
1101 0000 DO 
1100 0000 co 
1011 0000 BO 
1010 0000 = AO 
1001 0000 «9 
0000 0010 02 
0000 0011 03 
0000 0100 04 
0000 0101 05 
0000 0110 06 
0000 1000 08 
0000 0000 00 


Subclassification - 


Delete xxx] 
Replace xxx] 
Insert xxIx 
Chain xIxx 
Map I xxx 


XA 
RAK 
AAR 
MAXX 
XXKX 


Dictionary (CESD)—Internal Format 


1972,1985 
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See Figure 41 for normal combination of internal CESD types. 





Type Field | Chain Address 
Chain ID 
(bytes 9-11) 


CESD Entry Type 





Section Definition 


Private Code 


Pseudo Register 


External Reference 


Weak External Reference 


Label! Reference 


ER - Unmatched Lib- 
rory Member Name 


ER - Matched Library 
Member Name 


-0000 0010 Reverse chain 
10 (2) 


ER - Unmatched No 
Call Name 


ER - Matched No Gall 0000 0010 


ER - Never Coll 


ER - Overlay Control 
Stotement 


ER - Alias Control 
Statement 


ER - ddneme from 
Library or Include Statement 


ER ~ Include Control 
Statement w/o Pointer 


ER ~ Include Control 
Stctement with Pointer 


ER - Reploce Control 
Statement (3) 


ER - Control Delete (4) 


ER - Change Control 
Statement (3) 


Figure G1 (Part 1 of 2). 


cnn a 
cnx 0010 Hex 00 or 80 


00 


ooooono{ 
0000 0010 | Address of next 
item in the chain 
0000 0010 Address of next 
item in the chain 
0000 0010 | Address of next 
item in the chain 
0000 0010 | Address of next 
item in the chain 
0000 0010 | Address of next 
item in the chain 
0000 0010 | Address of next 
item in the chain 


0000 0010 | Address of next 
item in the chain 






AMODE/RMODE/RSECT 
Data or Segment Number 
(byte 12) 


ddname Pointer/ 
Chain [D/Length 
(bytes 14-15) 


ER Subtype 


(byte 13) 





Length of control section 
Length of common crea 


Alignment Length of pseudo register 
value (1) 


mom] 


foo oooof 
| I CESD entry no. of SD or PC (ID) 


CESD entry no. of 
next item (ID) 


CESD entry no. of 
next item ({D) 


0000 0011 


0000 0110 


Forward chcin 


1011 0000 
PTR (Library only) 
tan 
1101 0000 Pointer to li- 
brary’s ddnaome 


Normal Combination of Internal CESD Types 
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Notes: 
1. Alignment Value -- Specifies boundary clignment of the pseudo register 
00 = byte alignment 
01 = halfword clignment 
03 = fullword alignment 
07 = doubleword alignment 
BLDL has been issued for this member name if bit 64 is set to I. 
Two CESD entries cre mede for each Replace or Change control statement, one entry for each symbol. 
This entry results from a Replace o- Change control statement that contains only a single symbolic name. 
If segment number, 1 to 255. 
if AMODE/RMODE/RSECT data: 
MAMK oo. not used 
_R... RSECT information 
O = not read-only 
1 = read-only 
ee 5 ee RMODE data 
0= 24 
1° ANY 
ape 34 AA AMODE data 
00, 01 = 24 
10 = 31 
11= ANY 
6. If segment number, 1 to 255. 
Otherwise, zero or blank. 


GK &@WA 
e ° . e 


Figure 4G] (Part 2 of 2). Normal Combination of Internal CESD Types 








Delink Table 


Built by RLD Processor (Delink Routine), 
Referred to by Second Pass Processor, RLD Processor 





Address - assigned to the symbol being deleted (3 bytes) 


CESD entry number (ID) - the relocation pointer of an RLD item referring to the symbol that is 
replacing the identically named symbol (or symbols) to be deleted (2 bytes) 


Figure 42. Delink Table 








Downward Calls List 
Built by and referred to by ENTAB Size Determination Routine (HEWLFENS) 


Segment number - entries are one for one with those of the CESD. Ifa 
downward call is made to a symbol, the segment's number from 
which the call is made is entered in the downward calls list 


at an entry corresponding to the ESDID of the symbol in the 
CESD. The list is initially zero. (1 byte) 


Figure 43. Downward Calls List 
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Entry List 


Built by and referred to by Second Pass Processor 


-= 
entry (6 bytes) 






Address ~ linkage editor assigned address of the 
ENTAB entry for this symbol (3 bytes) 


Segment number - that will contain this ENTAB entry (1 byte) 


Half ESD entry number - corresponding to the CESD entry that 
contained the referred to symbol (2 bytes) 


Figure 44. Entry List 








Entry Table ‘ENTAB) 


Built by Second Poss Processor 


Urnconditionol branch to last Address of referred "to” seg Previous Coller 

entry-B8C 15, DISP 15,0) to symbol number (zero initially; 

Unconditional branch to last Address of referred “to” seg Previous Coller 

entry-BC 15, DISP °15,0) to symbol number (zero initially) 
l | | | | 
l | | | | 
| | | | 


Unconditional branc’s to last Address of referred “to” seg Previous Coller 
entry-BC 15, DISP -15,0. to symbol number {zero initially) 
"From" Address of segment 
BCR 15,15 “fable (SEGTAB) 


L 5, 4 (0,15) loads GR15 with 
- 2 bytes oe bytes —+— bytes —1.— 2 — vee bytes — 


the value of the adcon 
DISP -- is the displocement, in bytes, of this entry from the lost entry. 
"to" segment numbes -- is the number of the segment containing the symbol being referred to. 
“from” segment number -- is the number of the segment that contoins this entry table. 


Figure 45. Entry Table CENTAB) 
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Half External Symbol! Dictionary 


Built by Intermediate Output Processor 
Referred toby Second Pass Processor 








oT it % TT 


one 
entry (8 bytes) 


Length (3 bytes) 


if segment number, 1 to 255 (SD, CM, PC, LR) 
if AMODE/RMODE/RSECT data {SD, PC): 
MXXK.... not used 
. RR... RSECT information 
0 = not read-only 
1 = read-only 
eee oe RMODE data 
Q=24 
1= ANY 
Bib deca seed AA AMODE data 
00, 01 = 24 
10 = 31 
11 = ANY 


Alignment factor (PR} 
07 = doubleword 
03 = fullword 
O01 = halfword 
00 = byte 


Linkage Editor assigned address - of this symbol (ebsolute value of the address constant) (3 bytes) 


Indicator-Type - Bit zero is not used. Bits 1, 2 and 3 cre used os an indicator field that applies to: 
SD,PC - Bit 1 = 0 -- this control section (SD or PC) does not have 
the highest CESD entry number with text in this segment 
= 1} == this control sectian (SD or PC) has the 
highest CESD entry number in this seament 
SD, PC, or CM - Bit 2 = 0 -- relative relocation constant is a positive value 
= ] -- relctive relocation constant is in 
complemented form 
PC-delete - Bit 3 = 1 -- indicates that this unnamed control section 
is o SEGTAB or ENTAB. 


Bits 4, 5, 6 and 7 are used to specify the ent e: 
0000 = Section Definition cp) 
0010 = External Reference (ER) - all Fields are zero except type 
1010 = Weak External Reference (WX) 
0011 = Label Reference (LR) 
_ 0100 = Private Code (PC) 
0101 = Common (CM) 
0110 = Pseudo Register (PR) 
O111 = Null - all fields are zero except type 


Figure 46. Half External Symbol Symbol Dictionary CHESD) 
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High [D Table 
Built and referred to by Intermediate Output Processor 


re 6 a 





CESD entry number = entries are in segment number order. Each 
entry contains the highest CESD entry number 
(ID) assigned to a section definition (SD or PC) 
within that segment. (2 bytes) 


Note: If segment does not contain text, its corresponding entry contains zero. 


Figure 47. High ID Table CHIID) 
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Virtual Storage Allocation Table 


Indicators (1 byte ) 
Used by Allocation Processor 


Number of current entries 
TD 


Minimum Size - minimum number of bytes 
of virtual storage required for 


this table (2 bytes ) 


Weight - The factor used to allocate extra virtual storage 
to enlarge the table. It specifies how many 
bytes will be added to this table for every 582 
bytes (or 603 bytes, with overlay) which become 
available (2 bytes ). 


Number of Bytes per Entry - number of bytes per entry for 
this table (1 byte) 


Number of Entries - 156 - a value to which must be added 156 to 
determine the address in the all purpose 
table at which the number of entries value 
for this table is to be stored (1 byte ) 


Address - 156 - a value to which must be added 156 to determine the 
address in the all purpose table at which the determined 
address for this table is to be stored (1 byte) 


Indicators - (1 byte) 


Bit 0 - table needed to process overlay modules only 
Bit 1 - table needed during first pass 

Bit 2 - table needed for intermediate processing 

Bit 3 - table needed during second pass 

Bit 4 - table requires doubleword alignment 

Bit 5 - table requires word alignment 

Bit6- NA 

Bit 7 - table has a zero entry (prefix) 


End Flag - FF (1 Byte) 


Figure 48. Virtual Storage Allocation Table 
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Partitioned Organization Directory Record 
As received from BLDL 














































Byte 
P Name of load module (member or alias name) ! 
8 Concatenction 
Relative (to beginning of dota set) track address of module (TTR) cumber 
12 Byte of binary Alias indicctor and Relative (to beginning of deta set) 
zeros * miscellaneous info track address of first text record 

16 Continuation of Byte of binary Relative (to beginning of dato set) 

track oddress Zeros track address of note ist or scatter- 
20 translation record Number of entries Module attributes] (see Figure 50) 

in note list ** 0,1,2,3,4,5,6,7,8,9, 10, 11,12, 13, 14, 15 
24 Total contiguous quantity of virtual storage requred by the Length (in bytes) of 
module first text record 

28 Continuation of Module's linkage editor assigned entry point address 

length 
32 Module Attributes2 ~~ AMODE/RMODE information RLO count 

(see Figure 50) (see Figure 50) 

Length of scatter 
For load modules in scatter format add: 
36 list (in bytes) Length of translation table (in bytes) ESDID (CESD entry 
number of control 

40 








ESDID (CESD entry number of control 
section name) containing entry point 


Entry point address 
For load modules with elias names add: 


of the member name 


section name) for 
first text record 








SSI Bytes - Aligned on a halfword boundary at the end of the PDS record 


Legend: 
Alias indicator and miscellaneous information: 
Bit Meani 
Oo 0 signifies none 
| signifies clias 
1,2 number of relative track addresses (TTR) in user data field 
3-7 length of user data field (in halfwords) 
PODS Directory Record Size: 
Format Bytes 
Block 36 (with alias names, it is 46 bytes) 
Scatter 44 (with alias names, it is 54 bytes) 


Note: For SSI, add 4 bytes to sizes given above. 
*This is normally o zero byte inserted to maintain halfword boundaries. If the DCB operand was specified as zero and the name 
was found in the link library, this byte will contain a 1; if the name was found in the job librery, this byte will contain a 2. 
**This byte contains a zero if load module is not in overlay. 


Figure 49. Partitioned Organization Directory Record (CAs Received from BLDL) 
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Module Attributes 1 


Bit Number Attributes Bit Setting Indication 
0 RENT 0 Not reenterable 
l Reenterable 
1 REUS 0 Not reusable 
l Reusable 
2 OVLY 0 Not an overlay module 
l Overlay module 
3 TEST 0 Not under test 
1 Under test 
4 LOAD 0 Not only loadable 
1 Only loadable? 
5 Format 0 Block format 
l Scatter format 
6 Executable 0 Not executable 
1 Executable 
7 Format 0 Module contains more than one text 
record and/or RLD record(s) 
1 Module contains only one text 
record and no RLD record 
8 Compatibility 0 Module can be reprocessed by all 
levels of linkage editor 
1 Module cannot be reprocessed by 
linkage editor E 
9 Format 0 Linkage editor assigned origin of 
first text record is not zero 
l Linkage editor assigned origin of 
first text record is zero 
10 Format 0 Linkage editor assigned entry 
point is not zero 
1 Linkage editor assigned entry 
point 1s zero 
11 Format 0 Module contains RLD record(s) 
l Module does not contain an RLD 
record 
12 Editability 0 Module can be reprocessed by 
linkage editor 
1 Module cannot be reprocessed by 
linkage editor 
13 Format 0 Module does not contain TESTRAN 
symbol records 
1 Module contains TESTRAN symbol 
records 
14 Compatibility ] Module created by linkage editor F 
15 REFR 0 Module is not refreshable 
Note: 


1 Module can be loaded only with the LOAD macro instruction. When the module is 
in virtual storage, it is entered directly, not through the use of an XCTL, 
LINK, or ATTACH macro instruction. 


Figure 50 (Part 1 of 2). Module Attributes 
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Module Attributes 2 


Bit Number Bit Setting Indication 
0 1 Module has been processed by OS/VS linkage editor 
l 0 Reserved - Unused 
2 1 Page alignment required for load module 
3 1 SSI present 
G 1 Authorization code present in last 2 bytes of 


directory entry 


AMODE/RMODE Information 


>. aaa Not Used 
eRe sen RMODE for Load Module 
0 = 24 
1 = ANY 
. AA.. Wa ereer” the True Alias or Alternate Entry Point 

10 = 31 
11 = ANY | 

ieee eek ANODE for the Main Entry Point 
00 = 24 bo 3% 
10 = 3l 
ll = ANY 


Figure 50 (Part 2 of 2). Module Attributes 
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Parsitioned Organisation Directory Secord 


As built by biakage editor 


Byte 0 Nome of load module (member or clias name) 


: 
8 Relative (to beginning of data set)track address of Alias indicator and 
module (TTR) miscellaneous info (see below 

12 Relative (to beginning of dato set)track address of First Byte of binary 

text record (TTR) zeros 
16 Relative (to beginning of dato set)track address of note Number of entries 

list or scotter/translation record (TTR) in note list* 
20 Module Attributes 1 (see Figure 50) Total contiguous viitual storage required 

0, 1, 2, 3, 4, 9, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 
Length (in bytes) of first text record Modules linkage 








24 for the module 
28 editor assigned entry point address Module Attributes 2 AMODE/RMODE information 
(see Figure 50) (see Figure 5&0) 
32 Authorization Code Length** Authorization Code** 
For load modules in scatter format add: “es 
Length of scatter list (in bytes) Length of translo- 
tion table fin bytes) ESDID (CESD entry number of control - ESDID (CESDentry 
section name) for first text record number of control 
Authorization Code Length** Authorization Code** 
aintng entry potnt 
For load modules with alias names odd: 
Entry point oddress of the member name 


SSI bytes - Aligned on o halfword boundary at the end of the PDS 










40 













48 
52 


For load modules with SSI bytes: 





record, 
Authorization Code Length** Authorization Code** 
Legend: 
Alias indicator and miscellaneous information: 

Bit Meani 

Oo 0 signifies none 
1 signifies alias 

1,2 number of relative track addresses (TTR) in user dato field 

3-7 length of user data field (in halfwords) 


PODS Directory Record size: 


Format Bytes 
Block 36 -- when rounded to a halfword boundary (with olics names, 44 bytes) 
Scatter 44 (with alios names, 54 bytes) 


Note: For SSt, add 4 bytes to sizes given above. 
*This byte contains a zero if load module is not in overlay. 
**The cuthorization code fields will appear only once. They are always the lost fields of 
the directory record. The size of the directory determines in which of the four locations 
they cppecr. 


Figure 51. Partitioned Organization Directory Record (As Built by Linkage Editor) 
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Relative Relocation Constant Table 


Built by and referred to by Address Assignment Processor 


ee et ee 


Relocation Constant = (linkage editor assigned address)-(previously assigned eddress) of a 
control section (SD, PC or CM) or a label reference (LR). The 
entries are one for one with CESD, in true or complement form. Com- 
plement form specified by binary ones in the high-order byte (4 bytes) 





Figure 52. Relocation Constant Table CRCT) 








Renumbering Table (RNT) 


Built by ESD Processor 
Referred toby YXT, RLD, END and ESD Processor 





0000 Subclessification - 


Section Definition (SD) XXXX 

Label Reference (LR) xxxx 0071 Delete xxxT xxxx 
Private Code (PC) xxxx 0100 Replace xxxT  xxxx 
Common (CM) wou O10) Chain X1XK XKRKX 
Pseudo Register (PR) xox 0110 Insert xx 1X XKXK 
Null 0000 O111 Library Thoox KKK 
External Reference xxxx 0010 


Weak External Reference (WX) xxxx 1010 
(1 byte) 


Flag - to indicate that the section definition (SD or PC) to which this entry corresponds is present 
in the CESD (0000 0001), or that other CESD items are dependent on its presence (0000 0010), 
_ or that a Delink Table entry was created for this symbol (0000 0100) -- 1 byte 


CESD entry number (1D) - points to on entry in the CESD -= 2 bytes 


Figure 53. Renumbering Table CRNT) 
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RLD tnput Control Block* 


Build and referred to by Second Pass RLD Processor 








Address of RLD note list entry 
marking the end of the RLD 
grouping (4 bytes) 


Address of current RLD note list entry 
being processed (4 bytes ) 


Address of RLD note list entry marking the 
beginning of the RLD grouping (4 bytes ) 


Beginning address of RLD input buffer (4 bytes ) 


Lowest RLD address of unprocessed RLDs in current RLD set (3 bytes ) 


Flags (1 byte ) 
Bit O - 1 Control block in use 


Bit 3 - 0 Control block governs RLD input buffer 1} 
1 Control block governs RLD input buffer 2 








* There is a control block for each of two input buffers. 


Figure 54. RLD Input Control Block 
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RLD Output Control Block * 


Built and referred to by Second Pass RLD Processor 









Address of end of buffer - 4 
(4 bytes) 


Address of beginning of buffer (4 bytes) 


First free address in the buffer (4 bytes) 
Length in bytes of ID-length list (2 bytes ) 


Flags- Byte |! BitO- 1 Control block in use 
Bit 1-1 Buffer is being written 


Byte 2 Bit 8- 15 Constant to turn off use bits in 
the text control block 
For: Buffer } - X 'DB' 
Buffer 2- X 'ED’ 
Buffer 3- X 'Fé' 


* There is a control block for each of three RLD output buffers. 


Figure 55. RLD Output Control Block 
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RLD Note List 


Built and referred to by First Poss RLD Processor 


ee 


Address - displacement in words from beginning of record; TTR if last 
entry of a group (3 bytes) 


Length - number of words of RLD dota (2 bytes) 


Lowest Multiplicity - of the control section referred to by the ID field to which the 


RLD information in this record pertains (10 bits) 


Meaning 

0 = RLDs are not in virtual storage 
1 = RLDs are in virtual storage 

0 = Entry is grouped 

1 = Entry contains a TTR 


0 = Not processed 
1 = Processed 


O =RLDs are in Buffer | 
1 = RLDs are in Buffer 2 


0 = 
1 = Split RLD in set (Second Pass) 


0 
1 


Currently being processed (Second Pass) 


1D - CESD entry for the control section (SD or PC) to 


which this RLD information pertains (2 bytes) 


Figure 56. 


RLD Note List 
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Second Pass Text Control Block * 


Built and referred to by Second Pass Text Processor 


CCW displacement for text (4 bytes) 
Accumulated length of text (2 bytes) 


Length of current text (2 bytes) 


Address of text !/O table entry marking end of 
i text grouping (4 bytes) 


Address of text !/O table entry marking beginning of text 
grouping (4 bytes) 


Address of current text |/O table entry being processed (4 bytes) 


End address of text in buffer (4 bytes) 


Beginning address of text in buffer (4 bytes) 


Flags (4 bytes) 


Byte | BitO-1 Control block in use 
}-1 > Text being written 
2-1 Text being read 
Text has RLDs 
Text is first of group. 
Text is last of group 
Text is last in segment 
Text is last in load module 


te @ @ 1 
emi esd ae=@ at ant 


Byte 2 Bit XDAP write needed 

Dummy write needed 

RLD output buffer 1 is being used 

RLD output buffer 2 is being used 

RLD output buffer 3 is being used 

RLD output buffer 1 contains ID-length list for 

this text 

RLD output buffer 2 contains ID-length list For 

this text 

7-1  RLD output buffer 3 contains ID-length list for 
this text 


t 
est ett a=t st = #£4zanf 


Oe&Wwnh— © NOG & Ww 


oO 
( 


Byte 3 BitO-1 RLD input buffer 1 contains RLDs for this text 
1-1  RLD input buffer 1 contains processed RLDs for 
this text 
2-1  RLD input buffer 2 contains RLDs for this text 
3-1  RLD input buffer 2 contains processed RLDs for 
this text 
4-1. There is more text to process after current text 


* There are two text control blocks - - one for current text being processed, another 
for next text to be processed or text just processed. 


Figure 57. Second Pass Text Control Block 
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Segment Length Table (SEGLGTH) 
Built ond referred to by Address Assignment Processor 


Appecrance of table after assignment of control section addresses 





Highest ID or ENTAB Entry Count for Segment (2 bytes) 


Fleg (1 byte) 8its 0 through 3 not used 
Bit 4 = 0 ~= next two bytes contain the highest ID of the segment 


= 1 <= next two bytes contain the number of ENTAB entries for this segment 


Bits 5,6,7 - The low-order three bits of the previously assigned address of the first control section of 
this segment 


Cumulative Segment Length - in bytes, of control sections in this segment (including the ENTAB, if present) (3 bytes) 


Appeoronce of table after segment addresses ore determined 
Segment Relocation Constant - for the segment that corresponds to this entry (3 bytes) 
Poth Length - in bytes, of this segment, including this segment and its ENTAB (3 bytes) 


Figure 58. Segment Length Table (SEGLGTH) 
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Segment Table SEGTAB) 
Built by Intermediate Output Processor 


alee aaa Address of data control block (OC8) used to load module , 





Address of note list , 
Last segment Highest segment no. Last segment Highest segment no, 
number of region | in storage-region | number of region 2 in storoge-region 2 





Last segment Highest segment no, Lost segment Highest segment no. 
number of region 3 in storoge-region 3 number. of region 4 in storoge-region 4 









(Not used in the Fixed-Task Supervisor) ® 


(Not used in the Fixed-Task Supervisor) : 







Previous segment * 
number for segment | 


Stotus 
indicator 


Previous segment Address of entry toble entry (when caller Stotus 
number for segment 2 choin exists) * indicator 





Previous segment Address of entry table entry (when coller Status 
number for segment N chain exists * indicator 


Legend: 
TEST indicator -- specifies that this module is "under test" using TESTRAN. Bit 1 is initialized by program fetch. 
Highest segment no. in storage -- is initially set to 00 except for region | which is initially set to 01 by linkage editor. 
Status indicator -- indicates the status of this segment with the two lost bits of the entry table address field os follows: 


Bits Meaning 

00 segment is in virtual storage os a result of o branch to the segment. 
10 segment is in virtual storage ; no caller chain exists. 

01 segment is not in virtual storage, but isscheduled to be looded. 

HW segment is not in virtual storage. 


Note: The status indicator for segment 1 is initially set to 10; all the rest are initially set to 11. 
* Set to zero by linkage editor. 


Figure 59. Segment Table CSEGTAB) 








TABLE 
Referred to by HEWLMBTP 


ytT ETT ty | 


Pointer - to beginning of a group of entries in LIST (2 bytes) 





LIST 
Referred to by HEWLMBTP 






» IT Fe 


End of Message Indicator - delimits a group of entries that define 
a message (1 byte - hex FF) 


Pointer - to the first character of a phrase (2 bytes) 


Count-1 - of characters in the phrase (1 byte) 
Figure 60. TABLE and LIST (Referred to by HEWLFBTP) 
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TEXT I/O TABLE 


Built and referred to by First Pass Text Processor 


a 


Multiplicity Number of this piece of text (10 bits ) 





Fiags 

(6 bits)-- Bit | Meaning 

“0 0 Text is not in virtual storage 
1 Text is in virtual storage 


Corresponding TXT note list entry is a grouped entry 
Corresponding TXT note list entry containsa TTR 


— © 


Text not out-of-order 
Out-of-order text 


Lt) 
— © 


Text has not been processed (second pass) 
Text has been processed (second pass) 


Ww 
— oO 


Corresponding TXT note list entry contains a true length of the text 
Corresponding TXT note list entry contains a full multiplicity length 
which is lorger than the actual length of the text 


5 Not used 


pp 
_—oOo 


ID -- CESD entry for this control section (SD or PC) (2 bytes 
Figure 61. Text I/0 Table 








TEXT NOTE LIST 


Built and referred to by First Pass Text Processor 






Length - number of bytes of text (2 bytes) 


Address - storage address if text is in virtual storage, 
TTR if non-grouped entry or last 
entry in a group (3 bytes) 


Displacement - location of this text relative to the beginning 
of the multiplicity - used only for out-of-order 
text (2 bytes ) 


Figure 62. Text Note List 
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XAD2CESD TABLE 
Built and referred to by Cross-Reference Table Routine 





Composite ESD entry number - specifies the CESD entry containing the 
symbol (2 bytes) 


Figure 63. XAD2CESD Table (Built and Referred to by 
Cross-Reference Table Routine) 





ORDER TABLE 
Built by HEWLFSCN 


/ | | 





CESD Identifier (2 bytes) 


Indicators (I byte): Bit O - Entry matched in CESD 
Bit 1 - Unused 
Bit 2 - ORDER required 
Bit 3 - PAGE alignment required 


Bits 4-7 - Unused 


Figure 64. ORDER Table (Built by HEWLFSCN) 
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DIAGNOSTIC AIDS 


This section contains information that may be useful in 
diagnosing difficulties with the linkage editor program. 
Included are: register contents at major entry points 

(Figure 65), charts describing buffer (see Figure 66 on 

page 187) and table allocation (Figure 67 on page 188), and an 
a a cross-reference table (Figure 68 on 

page ; 


Module 

Entry Point Contents 
1 
2 


HEWLCIDR Pointer to parameter list 
Address of all-purpose table 
13 Address of save area 
14 Return address 
15 Entry point address 


HEWLFADA Lees Address Of S11 =surpece: table 


HEWNLFBTP 2 Address of all-purpose table 


Return address 


Entry point address 


Address of all-purpose table 


Save are address 


HEWLFENS 
HEWL FENT 


Figure 65 (Part 1 of 5). General Register Contents at Major Entry Points 


Return address 
Address of all-purpose table 


Save area address 





14 | 
15 
HEWLFEND 2 Address of all-purpose table 

G Length of any no-length control section 

5 ID of the assembled address of the module entry point 
13 Address of save area 

14 Return address 
15 Entry point address 

2 

13 

14 

2 

13 

14 


Return address 
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ea ee 


Address of all-purpose table 


Module 
Entry Point 


HEWNLFESD 


Byte count of ESD information 


ID of first ESD item to be processed 


Address of first ESD item to be processed 
Save area address 


Return address 





Entry point address 


Address of all purpose table 


Pointer to parameter list 


HEWLFFNL 
HENLFIDR 


en ee 
wm BP WwW HN MH HR | 


5 


Address of all-purpose table 
13 Address of save area 
14 Return address 


15 Entry address 


HEWLFINC 2 Address of all-purpose table 
12 Return address 

Entry point address 

HEWLFINP Address of all-purpose table 


Entry point address 


_—_ 
paot wi 


HEWLFINT Address of parameter list 
Save area address 

Return address 

Entry point address 
HEWLFMAP Address of all-purpose table 


Return address 


-— 
WG 


Address of entry point 


HEWLFOPT Address of parameter list 
Address of all-purpose table 
Return address 


Entry point address 
Address of all-purpose table 


General Register Contents at Major Entry Points 


HEWLFOUT 


— a —_ 
wm fH NHN Fi oo HB ADELE U 


Ti 
pat 
‘| 
¢ 
ae | 
@ 
oN 
wi 
vr 
ba) 
rh) 
| 
fam 
N) 
6 
= 
ui 
J 
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Module 
Entry Point 


HEWL FRAT 
HENLFRCG 


HEWLFREL 


HEWLFROU 
HENLEPNT 





Contents 


Address of all-purpose table 


Byte count of RLD input 


~ 2 |B 


Storage address of RLD input 





p= 
B=) 


Return address 

Address of all-purpose table 

Address of ESD item being processed 

Address of beginning of replace/change chain 
Entry point address 


HESD address of either first ENTAB entry Cif overlay) or: 
last HESD entry + 8 


Address of all-purpose table 
Return address 

Entry point address 

Address of parameter list 
Address of save area 

Return address 


Entry point address 


Address of all-purpose table 


Return address 
Entry point address 


Error Code 


HEWLFLOG 


Address of first symbol Coptional) 
Address of all-purpose table 
Address of second symbol Coptional) 
Return address 


Entry point address 


— — fe — — 
™N wm DH NI Uo ff Ww KI oN Bb A m~Iiw oo aA 


HEWLFALK Address of all-purpose table 
14 Return address 
15 Entry point address 





Address of first ENTAB entry in HESD, if overlay; 
otherwise, address of last HESD entry + 8 


HEWLFSCD 


Address of all-purpose table 


—_— 


Figure 65 (Part 3 of 5). General Register Contents at Major Entry Points 


LY26-3963-0 © Copyright IBM Corp. 1972,1985 Diagnostic Aids 185 


Contains Restricted Materials of. IBM 
Licensed Materials — Property of IBM 


-Medule — 
Entry Point 


GETIDMUL 


Reg | Contents 


Indicator: 0 - prime read; = lookahead 


Text control block address 
Return address 
Address of column 1 of input record | 


Address of all-purpose table 





Entry point address 





Address of all-purpose table 
Base register of HEWLFSIO 
Address of HENLFSCD 

Return address 

Address of HEWLFRLD 

Base register of HEWLFSIO 
Address of HEWLFSCD 





CHECKWRT 


Return address 


Address of HEWLFRLD 


Address of HEWLFRLD 





HEWLFSYM Address of all-purpose table 











‘Save area address 


Return address 













Entry point address 


WRTCRRLD Hl Address of control block for buffer to be written 
Base register of HEWLFSIO | 
7 Address of HEWLFSCD 
Return address 


HENL FTXT 


Address of all-purpose table 
Assembled address of first byte of text 
Byte count of TXT input 
ID of current text record 
Base register of HEWLFTXT 
Base register of HEWLFRAT 


Return address 


Figure 65 CPart 4 of 5). General Register Contents at Major Entry Points 
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Module 
Entry Point 


Contents 


RELOCATE Address of all-purpose table 
Address of text control block for current text 
Return address : 


Address of HENLFREL 


HEWLCAUT Address of all-purpose table 
Return address — 
Entry point address 





Figure 65 (Part 5 of 5). General Register Contents at Major Entry Points 


BUFFER ALLOCATION - ( LINKAGE ECITOR) 


Object Module Buffer | 
3200 bytes (mox.) or 800 bytes or 400 bytes (min.) 


Object Module Buffer 2 
3200 bytes (max .) or 800 bytes or 400 bytes (min.) 



























SYSLIN Buffer | 

3200 bytes (max .} or 800 bytes or 400 bytes (min.) 
SYSLIN Buffer 2 

3200 bytes (max .) or 800 bytes or 400 bytes (min.) 


Print Buffer 1 
4840 bytes (max.) of 1216 bytes or 608 bytes (min.) 
Print Buffer 2 
4840 bytes (max.} or 1216 bytes or 608 bytes (min.) 
RLD Buffer Area 
1024 bytes 


















Text Buffer Areo 
102400 bytes (max.) or 6144 bytes (min. 


Initial ond Input Intermediate Second Pass 
Processing Tobles Processing Tables Processing Tables 





Figure 66. Buffer Allocation 


a ch PT a SS 9 A SS SE ES Pc ETE I SII BOS LILLIA GED) 
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Allocated 















for Overlay 
Link-Edit Orderof Bytes/ Inp. Int. 2nd 
Table Name Only Allocation Entry Weight | Proc. 










Alias Table No <4 1 0 No Yes Yes No Dbiwd 160 160 
Calls List Yes 15 1 96 Yes Yes No No _ Dbiwd 1536 : 
Composite ESD No 8 16 288 Yes No No Yes  Oblwd 4608 : 
















Delink Table No 5 5 24 Yes Yes Yes Yes  DOblwd 384 : 
Entry List Yes 16 6 96 No No Yes No  Dblwd 1536 > 
Half ESD Yes No  Dblwd 2304 : 











Half ESD No 9 1 0 No Yes Yes No Dblwd 8 8 
Prefix 

HIERARCHY! No 13 1 18 Yes Yes No Yes Dblwd 288 : 
IDRTRTAB? No 17, 20 1 12,45 Yes Yes No No Dblwd 192, 208 *? 
IDRUDTAB No 18 1 88 Yes Yes No No _ Dbliwd 960 

IDRZPTAB No 19 1 44 Yes Yes No No  Dbiwd 455 3 
Order No 42 1 28 Yes Yes No No  ODblwd 456 > 
First Pass No 6 1 0 Yes No No No Dbiwd 256 256 


RLD Buffer 


Second Pass No 11 1 0 No No Yes No Dbiwd 768 768 
RLD Buffer 


Relocation 
Constant Table/ 


Renumbering No Yes  Dblwd 
Table 


RLD Note Yes Yes No Dbiwd 928 
List II 


SEGTA1 Yes Yes Yes Dblwd 256 256 


Text 1/0 Yes Yes No Dbiwd 
Table 


Text Note Yes Yes No Dbiwd 
List U1 


1 Not used in virtual systems. 
2 Table allocated in two parts. 
3 Maximum is determined by storage availability. 





Figure 67. Table Allocation 
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Figure 68 contains a list of error messages and the routines and 
CSECTs in which they originate. Each message contains a 
severity code in the last position of the message number. These 
severity codes are defined as follows: 


0 Indicates a condition that will not cause an error during 
execution of the link-~edited program. 


l Indicates a condition that may cause an error during 
execution of the link-edited program. 


2 Indicates an error that can make execution of the 
link-edited program impossible. 


3 Indicates an error that will make execution of the 
link-edited program impossible. 


G Indicates an unrecoverable error. Such an error causes 
termination of linkage editor processing. 


Error Issuer 
Message 


Number Error Message Text Routine CSECT 


IEWOO00 Control statement HENWLFSCN HEWLFSCN 


IEWO012 ERROR——Input contains invalid 2-byte relocatable HEWNLFREL HEWLFREL 
sah ener aa constant has not been 
relocated. 








ERROR—Input contains invalid V-type address HENLFREL HEWLFREL 
constant; constant has not been relocated. 


ERROR—Invalid entry point from END card; no HENLFENT HEWLFENT 
entry point assigned. 


eae sree contains invalid external symbol HEWLFENT HEWLFENT 


ae ERROR—Entry statement symbol printed is invalid | HEWLFENT HEWLFENT 


Cnot an external name); no entry point assigned. 


ERROR—END card symbol printed is invalid (not HENLFENT HEWLFENT 
an external name); no entry point assigned. 


HEWLFENT HEWLFENT 


HEWLFENT HEWLFENT 


IEWO073 ERROR—Entry statement symbol printed is not in 
root segment of overlay structure; no entry 
point assigned. 


assigned. 


ERROR——-END card entry point address printed is 
not in root segment of overlay structure; no 
entry point assigned. 


ERROR—Invalid entry point on END card; entry HENLFEND HEWLFEND 
point ignored. 


IEWO113 ERROR—Output module contains no control HENLFENT HEWLFENT 





IENO083 ERROR—END card symbol printed is not in root 
segment of overlay structure; no entry point 





HEWLFENT HEWLFENT 





sections in root segment of overlay structure; 
no entry point assigned. 


IENO123 ERROR—No ESD entries; execution impossible. HEWLFINP HEWLFINP 
HENLFADA HEWLFADA 


Figure 68 (Part 1 of 5). Error Message/Issuer Cross-Reference Table 
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Error 
Message 


Number 





IEWO132 
ITEWO143 
TEWO152 


TEWO172 


TEWO191 


TEWO2Z12 


TEW0234 


IEW0241 


TEW0254 


IEWO264 


IEWO272 


TEW0294 


TEWO3249 
IEWNO332 


TEW0342 
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Issuer 


Error Message Text Routine CSECT 


ERROR—Symbol printed is an unresolved external HEWLFADA HENLFADA 

reference. 

ERROR—No text. HEWLFOUT HEMLFOUT 
HENLFINP HEWLFINP 

ERROR—lInvalid overlay structure; no calls or HENLFENS HENLFENS 

branches made from root segment. 

Warning—Exclusive call from segment number HEWLFENS HEWLFENS 

printed to symbol printed - XCAL was specified. 


ERROR—Exclusive call from segment number HEWLFENS HENLFENS 
printed to symbol printed. 


ERROR—Invalid exclusive call from segment HEWLFENS HENLFENS 
number printed to symbol printed. 

Warning-——Main storage requirements for output HENLFADA HEWLFADA 
load module have exceeded 512K bytes. 

Warning—Overlay structure contains only one HEWLFADA HEWLFADA } 
segment - overlay option cancelled. 


ERROR—Expected continuation card not found. | HEWLFINP HEWLFINP 





ERROR—Card printed contains invalid input from HEWLFESD HENLFESD 
object module. HEWIFINP HENLFINP 
HEVWLFRAT HEWLFRAT 


ERROR-—Input from load module is invalid. HEMLFRAT HENLFRAT 
HENLFINP HEWLFINP. 
HEWLFESD HENWLFESD 


Warning—External symbol printed is doubly HEWLFESD HEWLFESD 
defined - ESD type definitions conflict. | 


ERROR—Table overflow - too many external HENLFESD HEWLFESD 





symbols in ESD. HEWLFADA HEWLFADA 
| HENLFSCN HENLFSCN 





ERROR—Table overflow - input load module  _ HENLFESD HEWLFESD 
contains too many external symbols in ESD. . 


ERROR—Load module from library specified HENLFINC HEWLFINC 
unacceptable to level F. 


ERROR——DDname printed cannot be opened. HEHLFINT HEWLFINT 
: HEWNLFRAT HENLFRAT 
ERROR—DDname printed had synchronous error. HENLFROU HEWLFROU 

HENLFFNL HEWLFFNL 


ERROR—Invalid statement - scan terminated. HENLFSCN HEWLFSCN 
ERROR——Maximum number of regions (4) exceeded. HEWLFSCN HEMILFSCN 
ERROR—Maximum number of segments exceeded. HEWLFSCN HENLFSCN 


ERROR——Maximum number of aliases (16) exceeded, HEWLFSCN HEWLFSCN 
excess ignored. 

a a specified does not contain HEWLFINC HEWLFINC 
module. 


Figure 68 (Part 2 of 5). Error Message/Issuer Cross-Reference Table 
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Error Issuer 






Message 
Number Error Message Text | Routine CSECT 


IEW0354 ERROR——-Table overflow - too many calls between HENLFRAT HEWLFRAT 
control sections. 


TEW0364 ERROR——Table overflow - input text exceeded HEWLFRAT HEWLFTXT 
maximum, or too many changes of origin in input. HEWLFOUT HEWLFOUT 









HEWLFADA HEWLFADA 
HEWLFRAT HEWLFRAT 






ERROR—Table overflow - input contains too many 
relocatable address constants, or too many 
control sections containing such constants. 


IENO374 
ERROR—Text record ID is invalid; card ignored. HEWLFRAT HEWLFTXT 
HENLFADA HEWLFADA 





IENO394 ERROR—Member not stored in library - permanent HENLFFNL HEWLFFNL 
device error. 

IEWO404 ERROR—Member not stored in library ~ no space HENLFFNL HEWLFEFNL 
left in directory. 

IEWO412 ERROR—Alias not stored in library - no space HENLFFNL WHEWLFFNL 
left in directory. 


ITENOG21 Warning—Member not stored in library - HENWLFFNL HEWLFFNL 
identical name in directory; will try to store 
under "TEMPNAME. ° 


IEWO432 ERROR—Library name printed cannot be opened; DD HEWLFINC HEWLFINC | 
card may be missing. 


IEW0444 ERROR—Table overflow - too many downward calls. HENLFREL WEWLFREL 


ITEW0454 ERROR——Table overflow - segment contains too HENLFADA HEWLFADA 
many downward calls. 


IEWO461 Warning—Symbol printed is an unresolved HENLFADA HEWLFADA 
external reference; NCAL was specified, or the 
. reference was marked for restricted no-call or 








never-call 


IEW0472 ERROR—Invalid alias entry point in overlay HENLFENT HEWLFENT 
structure. 

IEN0484 ERROR-~—Table overflow - too many external HENLFINP HEWLFINP 
symbols affected by relocation. 

IEN0N492 ERROR—Invalid name card found in library; card HEWLFSCN HENLFSCN 
ignored. | 
ERROR—Alias not stored in library - permanent HENLFFNL HEWLFFNL 
device error. 

IEWO512 ERROR——-INCLUDE statement syntax conflicts with HENLFINC HENLFINC 
record format of specified data set -— DDname 
printed. 

IEWO522 ERROR—Specified data set has unacceptable HENLFINC HENWNLFINC 
record format - DDname printed. 

IEWO532 ERROR——Blocksize of library data set exceeded HEWLFINC HEWLFINC 
maximum ~- DDname printed. 


TEWO543 ERROR~—Identical name in directory. HENWLFFNL HEWLFFNL 


Figure 68 (Part 3 of 5). Error Message/Issuer Cross-Reference Table 
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Error 
Message 


Number Error Message Text 






Contains Restricted Materials of IBM 
Licensed Materials ~~ Property of IBM 


Issuer 





Routine CSECT 


ERROR——-Common printed exceeded size of control HEWLFESD HEWLFESD 
section with identical name. 

ERROR—Invalid text origin, linkage editor HEWLFSCD HEWLFSCD 
processing terminated. 


IEW0572 ERROR—Common printed and subroutine have HENLFESD HEWLFESD 


identical name. 





under *TEMPNAME. ° 3 


card missing. 


Warning—Invalid member name; will try to store 





HEWLFFNL HEWLFFNL 


ERROR—Input data set blocksize is invalid. HEWLFINP HEWLFINP 
| HEWLFINT HEWLFINT 
ERROR—Input from object module is invalid - END HEWLFINP HEWLFINP 





IEW0614 ERROR—Length not specified for external symbol HENLFRAT HEWLFTXT 
printed. _ 


terminated. 


ERROR—-Address constant references null unnamed HENLFRAT HEWLFRAT 
control section. | oie 

ERROR—DDname printed had synchronous error - HENLFROU HENWLFROU 
XREF aborted. ~~ 

ERROR—Symbol printed appeared on control HENLFADA HEWLFADA 
statement but was not matched. 

ERROR—Conflict in order specified for symbol HENLFSCN HEWLFSCN 
printed. 


ERROR—Size value specified not large enough for HENLFROU HEWLFROU 
table requirements - linkage editor processing 


IEW0670 The specified identify data has been added to HEWLFIDR HEWNLFIDR 
the IDR for the control section name printed. 

IEWO682 ERROR——Control section name on an IDENTIFY HENWLFIDR HEWLFIDR 
control statement is incorrect, or the statement 
1s misplaced - IDENTIFY data ignored. 


ERROR—Table overflow - SIZE value specified not HENLFIDR HEWLFIDR 
large enough for CSECT IDR input - linkage 
editor processing terminated. 


ITEWO70G4 Unrecoverable error detected in CSECT IDR input HEWLFIDR HEWLFIDR 
- linkage editor processing terminated. 
TEWO714 | ERROR—Member not stored in library - STOW HEWLFFNL HEWLFFNL 


IEWI722 ERROR—Invalid alias name. HEWLFSCN HEWLFSCN 


IEW07 31 Warning—Alias matches member name - alias HEWLFFNL HEWLFFNL 
IEN0740 The signee ree action was taken for an EXPAND HEWLFSCN HEWLFSCN 
request. 


IEWO7 51 Warning—Invalid AMQDE/RMODE combination found HEWLFFNL HEWLFFNL 
in MODE control statement - ignored. 


workspace unavailable. 


ignored. 


“Tt 
} 
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Error Issuer 
Message 
Number Error Message Text Routine CSECT 


IEWO761 Warning—Invalid AMODE/RMODE combination found HEWLFFNL HEWLFFNL 
in PARM field - ignored. 

IEWO771 Warning—AMODE/RMODE data in MODE control HENLFFNL HEWLFFNL 
statement incompatible with OVLY option - 
ignored. | 

IEW0781 Warning-—AMODE/RMODE data in PARM field HEMLFFNL WEWLFFNL 
incompatible with OVLY option - ignored. 

IEWO791 Warning—Invalid AMODE/RMODE combination in ESD HEWLFESD HENLFESD 
data for the named CSECT - ignored. 

IENO801 Narning—Table overflow - too many external HEWLFFNL HERNLFFNL 
symbols —- MAP-XREF aborted. 


ERROR—Output module contains split relocatable HENLFREL HEWLFREL 
address constant, size value 2 specified not 

















large enough, constant has not been relocated. 
ITEWO0984 ERROR-—SYSPRINT blocksize exceeds maximum - HEWLFINT HEWNLFINT 

linkage editor processing terminated. 

ERROR——SYSPRINT DD card missing - linkage editor HEWLFINT HEWLFINT 

processing terminated. | 


Figure 68 (Part 5 of 5). Error Message/Issuer Cross-Reference Table 
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APPENDIX. CONVENTIONS/FORMATS 


This section contains linkage editor input conventions and 
record formats (see Figure 69 on page 195 through Figure 82 on 
page 204). 


INPUT CONVENTIONS 


Input modules (object or load) to be processed ina single 
execution of the linkage editor must conform with a number of 
input conventions. Violations of the following are treated as 
errors by the linkage editor: 


14 


All text records of a control section must follow the ESD 
record containing the SD or PC entry that describes the 
control section. 


The end of every input module must be marked by an end 
indication CEND record in an object module; EOM flag ina 
load module). 


Each input module may contain only one no-length control 
section (a control section whose length field in its SD or 
PD entry in the ESD contains zeros). The length must be 
specified on the END record of any module that contains a 
no~length control section. 


After processing the first text record of a no-~length 
control section, the linkage editor will not accept a text 
Seana of a different control section within the same input 
module. 


Any RLD item must be read after the ESD items to which it 
refers; if it refers to a label within a different control 
sear it must be read after the ESD item for that control 
section. 


The language translators must gather RLD items in groups of 
identical position pointers. No two RLD items having the 
same P pointer can be separated by an RLD item having a 
different P pointer. 


Each record of text?* and each LD or LR entry in the ESD 
record must refer to an SD or PC entry in the ESD. 


The position pointer of every RLD item must point to an SD 
or PC entry in the ESD. 


No LD or LR may have the same name as an SD or CM. 


All SYM records must be placed at the beginning of an input 
module. The ESD for an input module containing test 
translator statements must follow the SYM records and 
precede TXT records. 


The linkage editor accepts TXT records that are out of order 
within a control section, even though linkage editor 
processing may be affected. TXT records are accepted even 
though they may overwrite previous text in the same control 
section. The linkage editor does not eliminate any RLD 
items that correspond to overwritten text. 


A common (CM) control section cannot contain text or 
external references. 
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During a single execution of the linkage editor, if two or 
more control sections having the same name are read in, only 
the first control section is accepted; the subsequent 
control sections are deleted. 


The linkage editor interprets common (CM) entries in the ESD 
(blank or with the same name) as references to a single 
control section whose length is the maximum length specified 
in the CM items of that name (or blank). No text may be 
contained in a common control section. 


Within an input module, the linkage editor does not accept 
an SD or PC entry after the first RLD item is read. 


To avoid unnecessary scanning and input/output operations, input 
modules should conform with the following conventions. Although 
violations of these rules are not treated as errors, avoiding 
them will improve the efficiency of linkage editor processing. 


RECORD FORMATS 


Within an input module, no LD or SD may have the same name 
as an ER 


Within an input module, no two ERs may have the same name. 
Within an input module, TXT records may be in the order of 
the addresses assigned by the language translator. (CIf TXT 
records are not in address sequence, each reorigin operation 
may require additional linkage editor processing time. ) 


SYSUT1 record size should be at least as large as SYSLMOD. 


Figure 69 through Figure 82 on page 204 are the card image and 
load module record formats for the linkage editor. 


SYM Input Record (Card Image) 


[=| bdenOOCOCSCSC~CSCSCSCSY 


Not used 


TESTRAN data 


Number of bytes of TESTRAN data 


Blank 


SYM 


12-9-2 (0000 0010) 


Figure 69. SYM Input Record (Card Image) 
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ESD Input Record (Card Image) 


ESD Data - see below (up to 3 data items per record) Not used 
Blank if all ESD items are LD 
ESD IDENTIFIEIRof first ESD item (other than LD) 
Blank 
Blank Number of bytes of ESD data 





ESD 
12-9-2 (0000 0010) 
ESD Data Item 


Zero - if length is on END record. 
" Length of control section (if type is: SD, PC, CM) 
Identifier of SO entry containing name 
Blank if type is ER, WX 
Length of pseudo register (PR) 


—— Alignment factor (PR) 
07 — doubleword alignment 
03 — word alignment 
01 — halfword alignment 
00 — byte alignment 
AMODE/RMODE/RSECT data (SD, PC) 
XXXX.... not used 
oe Rize RSECT information 
0 = not read-only 
1 = read-only 
pone .e Res RMODE data 
0=24 
1=ANY 
ere AA AMODE data 
00,01 = 24 
00 = 31 
11 = ANY 
Blank (LD, ER, CM, Null, WX) 


24 bit address (SD, PC, LD) 
Type - Hex (00=SD, 01=LD, 02=ER, 04=PC, 05=CM, O06=PR, OA=WX) 


Name - when type is: SD, LO, ER, CM, PR, WX 
Blank - when type is: PC or blank CM 


Figure 70. ESD Input Record (Card Image) 
a a 
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Text Input Record (Card Image) 


24 [s] ee priohschargisig 7-7 73-0 


Text dato (machine language code) Nigeuiea 
ESD Identifier of SD for control section of this text 
Blank 
Number of. bytes of text data 
Blank 
24 bit address of first byte of text dota 
Blank 
TXT 
12-9-2 (0000 0010) 
Figure 71. Text Input Record (Card Image) 








RLD Input Record (Card Image) 


pfea | sro frediors |e 


RLD data - see below Not used 


Blonk 


Number of bytes of RLD data 
Blank 
RUD 


12-9-2 (0000 0010) 
RLD data item 


12 |b )6.7.8 


Assigned address of address constant 










Flag field -- (TTTTLLSTn) 
~ $1T 


T= S=Direction of relocation 


0000=nonbranch O=positive (+) 

0001=branch l=negative (-) 

001 1=pseudo register cumulative length Tn=type of next RLD item 
LL=length of address constant O=next RLD item has a different R or P 
01=2 bytes pointer; they are present in the next item 
10=3 bytes T=next RLD item hos the some R and P point- 
11=4 bytes ers, hence they ore omitted 


Position pointer (P) - ESDID of SD for control section that contains the address constant 
Relocation pointer (R) - ESDID of CESD entry for the symbol being referred to (zero (00) if type=PR cumulative length) 
Figure 72. RLD Input Record (Card Image) 
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END Input Record - Type | (Card Image) 


pee Js] os | ove pst) 20 EE ee 


See Below 
Control! section length for control section whose length was not specified 
in 5D ESD item. Bere 29 is binary zero if length is present. 


ESDID of SD item for this contro! section that contains the entry point address specified in columns 6-8. 


Blank 





Blank 
24 bit address of entry point (optional) 
Blank 
END 
12-9-2 (0000 0010) 


Figure 73. END Input Record—Type 1 (Card Image) 








END Input Record - Type 2 (Card Image) 


tae [siete face fame Pm 





See Below 
Control! section length for control section whose length was not specified 
in SD ESD item 
Blank 
Symbolic entry point name (options!) 
Blank 
END 


12-92 (0000 0010) 


Figure 74. END Input Record—tType 2 (Card Image) 
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When present, same format as 
columns 34-52, but data applies 
to a processor which produced 
the source code for the processor 
described in columns 34-52 


(PL/S compiler) 





Day of year (date of compilation or assembly) 
Last two digits or year (date of compilation or assembly) 


Modification level of processor (01 to 99) 
Version level of processor (01 to 99) 


Translator identification - PID order number or equivalent, 
left. justified and padded to the right with blanks. 
Flag field: 
Blank = no IDR information in this record (provides 
compotibility with existing format) 
EBCDIC 1 = one IDR item follows 
3CDIC 2 = two IDR items follow 


Figure 75. IDR Data in an Object Module End Record 








SYM Record - (Load Module) 


SYM data and ESD data (ESD type SD, CM, and PC items) - (naximum of 240 bytes) 







Count - in bytes, of SYM and ESD data (2 bytes) 


Subtype - specifies information for TESTRAN - (1 byte) 

1000 0000 - this SYM record contains ESD items (SD, PC or CM) from 
a load module that was not "under test". The TEST attribute 
was not specified when it was link edited. 


0000 0000 - this SYM record is not the above type. 





Identification - specifies this is a SYM record -- 0100 0000 (1 byte) 


Figure 76. SYM Record (Load Module) 
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CESD Record - (Load Module) 








ESD dato ~ soe below 
Count - in bytes, of ESD data (2 bytes) 
ESDID of first ESD item (2 bytes) 


Spare - binary zeros (2 bytes) 
Flag (1 byte) 


“Identification -- 0010 0000 (1 byte) 


CESD Data (Load Module) 


TS 


Oxxx xxxx — byte 12 of CESD data items contains segment numbers 
1xxx xxxx — byte 12 of CESD data items contains AMODE/RMODE/RSECT data 


0} 1]2-3} 4,5 | 6,7| 8-247 up to 240 bytes of ESD dato 


IDAlength - length (3 bytes), when type is: SD, PC, CM, or PR 
ID (2 bytes), when type is LR 
zero (3 bytes), when type fs WX, Null or ER (Hex '06' indicates never call) 


Zero (ER, WX, Null) 


If flag byte (byte 1) indicates CESD data items contain segment numbers, segment number (SD, PC, CM, LR} 
If flag byte (byte 1} indicates CESD data items contain AMODE/RMODE/RSECT data — 


XMXX .... not used 


. R... RSECT information 
0 = not read-only 


1 = read-only 
ister Rise RMODE data 


0= 24 
1° ANY 
ee ie AA ANODE data 
00, 01 = 24 
10 = 31 
11 = ANY 
(SD, PC) 
Alignment factor (PR) 
07 = doubleword 
03 = fullword 
01 = halfword 
00 = byte 


Address - linkage editor assigned oddress of this symbol. Zero when type is ER, WX or Null (3 bytes). 


Type - Section Nefinition (SD) 
~~ Label Reference (LR) 
Private Code (PC) 
Common (CM) 
Pseudo Register (PR) 
Null 
External Reference (ER) 
Week External Reference (WX) 
(1 byte) 
Private Code marked daleto 


xxxx 0000 
wexx 0011 
x00c 0100 


xxxx 0101: 


xxxx 0110 
0000 0111 
woos 0010 
woe 1010 


Subclassification 
elete xxx 1 x02000% 
Replace 20067 200% 
Insert xT xxx Note: x may be 1 or 0. 
Chain x1xx 200% 
Map Thee 2000 


(ENTAB and SEGTAB contro! sections) x01 «100 
Symbol - The eight-character external name (zero when type Is Null) 


Figure 77. CESD Record C€Load Module) 
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Scatter/Transiation Record 


| . Up to and including 1020 bytes 







Data - may contain translation table or scatter table; or both, if both will fit in 1020 bytes. 
Count - in bytes, of data field (2 bytes) 
Zero - binary zeros (1 byte) 


Identification - identifies this as a scatter/translation record - 0001 0000 (1 byte) 


Transtation Table 


Padding—if necessary, to force fullword boundary alignment 
of scatter table (2 bytes) 
Translation Table Entry - pointer to the scatter table entry that contains 

the address of the control section containing 

this CESD entry. Number of translation table 

entries = number of CESD entries +1 = n. 

Pointer will be zero if its corresponding CESD 

entry is not SD, PC, CM, or LR. (2 bytes) 





Zero - binary zeros (2 bytes) 


Scatter Table 


- 


een, 


Scatter Table Entry (4 bytes) 


mh ty ti J 


Assigned Address - of a control section (SD, PC, or CM) (3 bytes) 


Flags (1 byte) 
XXXX..X, not used 
.. R... RSECT information 

0 = not read-only 
1 = read-only 

eee oR.. RMODE data 
0= 24 
1= ANY 

Spare eat H Hierarchy (OS/MVT) 
O = processor storage 
1 = 2361 storage 

Zero - binary zeros (4 bytes) 








Translation Table and Scatter Table 


Wtf] Ts Ts Ts Js Sy fT ty Ts 


Scatter Table Entry 
Binary Zeros (4 bytes) 







Translation data (2 bytes) Padding - if necessary to align scatter table to a fullword boundary (2 bytes) 


Binary Zero (2 bytes) 


Figure 78. Scatter/Translation Record 
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Control Record - tLoad Module 





' Control Data -- see below 


L Channe! Command Word (CCW) - that could be used to read the text record that follows. The data address field’ 
contains the linkage editor-assigned address of the first byte of text in the text record that follows. 
The count field contains the length of the succeeding text record. (8 bytes) 


Count - binary zeros (2 bytes) 


- Count - in bytes, of the control data (CESD ID, length of control section) following the CCW field (2 bytes) 


— Count (1 byte) - of RLD and/or CTL/RLD records following next text record 
Spore - binary zeros (2 bytes) 
Identification (1 byte) ~ specifies that this is: 
@ a control record - 0000 000! 
e the control record thot precedes the last text record of this overlay segment - 0000 0101 (EOS) 


@ the control record that precedes the last text record of the module - 0000 1101 (EOM) 


Control! Dota 







Length of text record and/or length of control section - specifies the 


length of the control section (in bytes) to which the text in the 
following record belongs, or the number of bytes of a control 
section contained in the following text record (2 bytes) 


CESD entry number - specifies the composite external symbol dictionary entry that 
contains the control section name of the control section of which this text is a part (2 bytes) 


Figure 79. Control Record (Load Module) 
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Relocation Dictionary Record - (Load Module) 


jofr.2]afasle7] sas 16-255 Record length can be between 24 and 256 





RLD doto -- see below 
Spore - binary zeros (8 bytes) 


Count - in bytes, of the relocation dictionary information following the spore 8-byte field (2 bytes) 





Count - binary zeros (2 bytes) 
Count {1 byte) - of RLD and/or CTL/RLD records following next text record 
Spore - binary zeros (3 bytes) 
identification () byte) - specifies thot this is: 
@ arelocation dictionary record - 0000 0010 


e the fast record of the segment - 0000 0110 
e@ the last record of the module - 0000 1110 


RLO Dota 
a ce 


Address - linkage editor assigned address of 
the address constant (3 bytes) 






Flag (1 byte) When byte format is xxxxLLST, 
specifies miscellaneous information as follows: 
xxxx specifies the type of this RLD item (address constant). 
0000 -- nonbranch-type in assembler language, DC A (name) 
0001 -- branchtype in assembler lenguage, DC V (nome) 
0010 -- pseudo register displacement value 
0011 -- pseudo register cumulative displacement value 
1000 and 1001 -- this address constant is not to be relocated becouse it refers to cn unresolved symbol 
LL specifies the length of the address constant. 
Ol -- two byte 
10 -- three byte 
11 -- four byte 
S specifies the direction of relocation. 
0 -- positive 
1 -= negative 
T specifies the type of the next RLD item. 
0 -- the following RLD item has a different relocation and/or position pointer 
1 -+ the following RLD item has the some relocation end 
position pointers os this and therefore is omitted 
Position pointer (P) - contains the entry number of the CESD entry (or translation table entry) 
~~ thet indicates which contro! section holds the address constant (2 bytes) 


Relocation pointer (R) - contains the entry number of the CESD entry (or translation teble entry) thet indicates which symbol value 
is to be used in the computation of the address constent's value (2 bytes) 


Figure 80. Relocation Dictionary Record (Load Module) 
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Control and Relocation Dictionary Record - (Load Module) 


GE ee FD, 


Length of control section 
or text record (2 bytes) 
CESD entry number (2 bytes) 
Address 
Flog 


Address (3 bytes) 
Flog (1 byte) 
Position pointer (2 bytes) 


Relocction pointer (2 bytes) 
Channel Command Word (8 bytes) 
Count, in bytes, of RLD information (2 bytes) 
Count, in bytes, of control information following the lest RLD address field. 


The control information contains the ID and length of control sections in the 
following text record, (2 bytes) 


Spare (3 bytes) 
Identification (I byte} - specifies thet this record is: 
@ a control and RLD record - 0000 0011 - {it Is followed by a text record) 


@ a control and RLD record that is followed by the last text record of a segment - 0000 0111 (EOS) 
@ a contro! and RLD record that is followed by tho lost text record of a module = 0000 1111 (EOM) 


Notes: For detailed descriptions of the data fields see Relocation Dictionary Record and Control Record. 
The record tength varies from 20 to 256 bytes. 


Figure 81. Control and Relocation Dictionary Record (Load Module) 








CSECT Identification Record 


record length 7 to 256 bytes 


IDR data - see below 








Sub-Type Indicator - specified type of IDR data 

contained on this record (bits 1-3 reserved) 

---- 0001 data supplied by HMASPZAP 

---- 0010 Linkage Editor data 

---- 0100 Translator-supplied data 

---- 1000 User (System)-supplied data (from IDENTIFY function) 
|--- ---- Indicates the last IDR of this load module 


Byte Count - of IDR data in this record, 
including this field (value range 6 to 255). 


Identification - indicates that this ts: 
1000 0000 - a CSECT Identification record. 


Figure 82 (Part 1 of 3). Record Format of Load Module IDRs 
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HMASPZAP Data 


ee 


Up to 18 repetitions of bytes 1 through 13 









Data specified during HMASPZAP processing * 


Data of HMASPZAP processing (packed decimal) YYDDD 


ESDID of CSECT processed by HMASPZAP 


Flags and count 


Bit O - reserved 

Bit 1 - chain bit - a 1 indicates that the next record is 
also available for HMASPZAP data. 

Bits 2-7- number of HMASPZAP entries used on this record 
(value range 0 to 19) 


*May be o PTF number or up eight bytes of variable user 
data specified on an HMASPZAP IDRDATA control 


statement. 


Linkage Editor Data 


Date of last linkage editor processing 
of this module (packed decimal) YYDDD 







Version and Modification level of the linkage editor 
that produced this module (packed decimal) VVMM 


Program Name of the linkage editor that produced this module 


Figure 82 (Part 2 of 3). Record Format of Load Module IDRs 
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Translator description (see below) 


Translator Data 


jot] verotle | 


ESDID (s) of CSECT (s) whose object code was produced by the translator 
described in this data item. This field is repeated as many times as 
necessary with the high order bit of the last ESDID ir the list set to 1. 





Translator Description (This portion is an optional extension for PL/S) 








When present, same as bytes 1-15, but data 
applies to a translator whose output is source 
code (a PL/S compiler) 


Date of compilation/assembly (packed decimal) YYDDD 
Version and Modification level of translator (packed decimal) VVMM 


Program name of translator, left justified and padded to the right with blanks 





Indicator 
0000 0000 - only one translator was described on object END card for these CSECTs 
0000 0001 - two translators were described on object END card (that is, PL/S. Compiler 
and Assembler) and are included here. 


User Data (Linkage Editor IDENTIFY Function) 


From | to 40 bytes of variable user (or system) supplied 
data as specified on the Linkage Editor IDENTIFY, control 
statement. Assumed to be printable EBCDIC characters. 












Count - number of characters in the user data field 


Date on which this data was supplied to the module via the linkage 
editor IDENTIFY control statement. | 


— ESDID of the CSECT to which the user data applies. 


Figure 82 (Part 3 of 3). Record Format of Load Module IDRs 
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INDEX 
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A-type address constant 
delinking of 
relocation of 61 
RLD processing for 45 
absolute relocation 18 
See also absolute relocation factor, 
relocation 
examples 63 
in entry processing 56 
absolute relocation factor 62 
See also absolute relocation 
definition 62 
determination of 45 
use in relocating delinked address 
constants 62 
use in relocating V-type address 
constants 
adcon 
See address constant 
additional call libraries 
See LIBRARY statement 
additional input sources 
See INCLUDE statement 
address assignment 59 
See also address assignment processor 
function 2-3 
general description 17 
in cross-reference table 59 
of first text record as zero 8 
of main entry point 56 
address assignment processor CHEWLFADA) 
description of 51-53 
chart 127 
Synopsis 94 
operation diagram 87 
address constant 3 
See also A-type address constant, 
pseudo register, V-type address 
constant 
computing the value of 4 
delinking 45, 66 
in RLD processing 45 
purpose 3 
relocation 61, 71 
See also address assignment 
addressing mode 1 
addressing mode (CAMODE) 8 
ALIAS statement 
general description of processing 24 
operation diagram 
processor 29 
alias table 
construction of 56 
format 161 
introduction to 17 
ALIGN2 format attribute 7 
all purpose table CAPT) 
format 151 
indicators for MAP, XREF options 58 
introduction to 15 
making an entry in 89 
preparation of 19, 89 
allocation 


of buffers and tables 21-22 
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of virtual storage 21, 22, 169 
initialization 15 
aopocten processor CALLOO1l) 89 


See all-purpose table. 
attributes and options processor 
CHEWLFOPT) 
attributes, module 
analysis of CHEWLFOPT) 8&9 
descriptions 6-8 
incompatible (table) 19 
processing examples 8-1ll 
use of 6-8 
authorization code 
in partitioned organization director 
record 173 
authorization code CAC) 8 
automatic library call 1 
See also automatic library call 
processor 
function 1 
automatic library call processor 
CHENLCAUT) 
description of 49-5l 
charts 121, 125 
synopsis 94 
automatic promotion of common 38 
automatic replacement 


blank common 

See also common 

definition of 34 

delinking of 66 

in resolution processing 37 
BLDL list, making an entry in 48, 50 
BLDL macro instruction 47, 4 
block format attribute 7 
blocked input 

on SYSLIB 23 

on SYSLIN 23 
blocked output 

on SYSPRINT 23 
boundary alignment factor 52 
branch-type address constant 

See V-type address constant 
buffer allocation 22, 187 


Le | 


call library | 
See automatic library call, SYSLIB 
data set 
calls 
downward 54, 67 
exclusive 54, 67 
invalid exclusive 67 
upward 54, 67 
calls list 
format 162 
making entries in 17, 45 
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scanning 51-55 
calls, automatic library 
See automatic library call 
CESD 
See composite external symbol 
dictionary 
CESD entry number 27, 83 
CESD identifier 35-37, 93 
CESD record 
format 200 
in input load module 32, 34 
CESD record types 34 
CHANGE statement 
operation diagram 82 
processing 24 
processor 28 


See common 
combining object modules ] 
common (CM) 
See also blank common 
definition 
delinking of 66 
nonresolution processing 36 
resolution processing 
Common path routine CHEWNLCPTH) 
automatic promotion of common 38 
in program organization 95 
communication area 
See all purpose table 
composite dictionaries 4, 5 
See also composite external symbol 
dictionary, relocation dictionary 
composite ESD 
See composite external symbol 
dictionary 
composite external symbol dictionary 
CCESD) 
contents 9 
definition 34 
internal format 163, 165 
introduction to 4 
making an entry in 15, 93 
written out on SYSLMOD 57 
concatenated data sets 
on SYSLIB 12 
on SYSLIN Ill, 23 
control dictionaries 3 
See also external symbol 
purpose 3 
when generated 3-5 
control information processing 
analyzing 
description of 19 
operation diagram 82 
control record 
contents 10 
in input module 32 
control section (CSECT) 2 
See also no-length control section 
assigning addresses to 2-3 
delinking of 66 
grouping on SYSLMOD 60 
replacement 38, 65 
control section search routine 
CGETIDMUL) chart 137 
in program organization 95 
control statement 
format 24 
operands - 24 
operation diagram 82 
Pointers (Pl, P2) 24 
processing 15, 24-31 
work areas COPDO, OPD1) 24-25 
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control statement scanner CHEWLFSCN) 


processing 
synopsis 93 
control/RLD dictionary record 10- 
See also control/RLD record write 
contents 10 
creation of 59, 95 
format G 
control/RLD record 
See control/RLD dictionary record 
control/RLD record write routine 
CNRTCRRLD) 95 
cross-reference between control 
sections 3 
cross-reference table 59 
See also options 
XREF option 
See also options, XREF option 
contents 59 
detailed description of 
production 
in program organization 94, 96 
CSECT identification record CIDR) 
contents 1, 
data types 
See IDR data types 
description 9-10 
formats 
IDENTIFY control statement 41 
in load module 16, 39-40, 41 
in object module END records 39-40 
processing CHEWLFIDR) 
description of 39-41 
operation diagrams 82 
program processing history 1 
written out on SYSLMOD 17 


[> ] 


data control block 
initializing 15, 93 
ae used to determine module type 12 
pagers downward compatible attribute 
See data control block 
DCBS option 
function 6 
delink table 
contents 16 
format 165 
making an entry in 45 
delinking 
definition 65 
example 
in RLD processing 46 
of A-type Cnonbranch-type) address 
constants 
of common control sections 66 
of external symbols 
dense record 43 
determining ESD type 34 
diagnostic aids 
buffer allocation 187 


error message—module cross-reference 


table 189 
register contents at entry to 
module 183 


table allocation 188 
diagnostic directory print routine 
CHENLFBTP) 
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in program organization 96 
LIST used during processing 180 
TABLE used during processing 180 
diagnostic messages construction 73 
See also error logging 
diagnostic output data set 
See SYSPRINT data set 
diagrams, operation 15, 75-88 
directory, microfiche 1496 
downward call 54, 67 
downward calls list 
format 165 
introduction to 17 
downward compatible attribute (DC) 
definition 
grouping control sections 60 
downward reference 54%, 67 
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end of module (E0M) indicator 3 
See also END record 
description of 3 
in control record 10 
in END processing 93 
setting 61 

end of segment CEOS) indicator 

in control record 
setting 

END processing CHEWLFEND) 
description of 47 

chart 115 
synopsis 93 

END record 
containing IDR data 39-40 
format 198 
in entry processing 56 

END record (continued) 
in object module 3l 

end-of-module CEOM) indicator 
See also END record 
in input load module 32 

ENTAB 
See entry table 

enter routine 36 

entry list 
contents 18 
format 166 
relocation 18 
use of 66 

entry point 8 
See also ENTRY statement 
assigned by linkage editor 8 
in END processing 
processing 56 

entry processor eee 
description of 

charts 129 

ENTRY statement 


general Hescrapiion of processing 24 


operation diagram 82 
processor 
entry table CENTAB) 


See also entry table creation routine 
17 


entries in CESD 
format 166 
introduction to 10 


PC-delete entry for 34, 52 
used in relocating V--type address 
constants 
entry table creation routine (SCDENTAB) 
description of 68 
in program organization 95 
entry table size determination routine 
calls list format 
Processing 54-55 
processing chart 128 
EOM 
See end of module indicator 


See external reference 
error logging 
description of 73 
routine CHEWLFLOG) 
chart 145 
table and list used 180 
error message/issuer-——module 
cross-reference table 189 
error messages 
See diagnostic messages 
error processing 
See diagnostic directory print 
routine 
See error logging 
ESD 
See external symbol dictionary 
ESD ID 
See ESD identifier 
ESD identifier 
definition 4 
entry in high ID table 58 
in entry processing 56 
in ESD processing 35 
in text processing 43 
ESD record 
definition 16 
format 196 
in object module 31 
operation diagram 83 
processing 35-39 
ESD record types 34 
exclusive call 54, 67 
See also options, XCAL option 
executable attribute 7 
EXPAND statement 
general description of processing 24 
EXPAND statement processor 
external dummy section 
See pseudo register 
external reference CER) 
definition 2, 
entry processing 35 
nonresolution processing 37 
resolution processing 34, 38 
unresolved ER processing 53 
external symbol definition 4 
external symbol dictionary (CESD) 
contents 4 
entry types 34 
identifier 
See ESD identifier 
introduction to 4 
processing CHENLFESD) 
description of 35-39 
description of chart 106 
description of synopsis 92 
operation diagram 83 
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final linked address 53 
final processing CHEWLFFNL) 
description of 18, 72 
charts 144-145 
synopsis 95 
objective 
operation diagram 81 
overview 14 
final relocation constant 53 
first pass RLD buffer 
See RLD buffer 
formats, record 195-206 
freeline routine 36 
functions of the linkage editor 1-2 
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general registers, contents of 33 
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half ESD table CHESD) 

contents 1] 

format 167 

in ENTAB creation 68 

production of 58, 94 

saving relocation factors in 61 
HESD 

See half ESD table 


HEWLCPTH 
See Common path routine 
HENLCRO] 

See SYNAD routine 
HEWLFADA 


See address assignment processor 
HEWNL FAUT 

See automatic library call processor 
HEWLFEND 

See End processing 
HEWLFENT 

See entry processor 
HEWLFESD 

See external symbol dictionary 

BEoeeaetny 

HEWLFFNL 

See final processing 
HEWLFIDR 

aee CSECT identification record 
HEWLFINC 

See include processing 
HENLFINP 
| See input processing 
HEWLFINT 

See initialization processing 
HEWLFLOG 

see error logging, routine 
HEWLFMAP 

See MAP/XREF processor 
HEWLFMDI 

See object module processing 
HEWLFOPT 

See attributes and options processor 
HENL FOUT 

See intermediate output processor 
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HEWL FRAT 

See text and RLD processor 
HEWLFREL 

See RLD control block, second pass 

text control block format 
HENLFROU 

See linkage editor, entry point 
HEWLFSCD 

See second pass processing 
HEWNLFSCN 

See control statement scanner 
HEWLFSIO 

See second pass processing 
HENLFSYM 

See symbol record, processor 
HEWLFTXT 

see text record, processing 
HEWLMBTP 

See diagnostic directory print 

routine 

HIARCHY 

See hierarchy format attribute 
HIARCHY statement 

general description of processing 24 

processor | 
hierarchy format attribute CHIAR) 7, 24 
hierarchy table 28 
high ID table CHIID) 

construction of 94 

contents 17 

format 168 

making an entry in 58 
HMASPZAP data 40 

See also IDR data types 

processing (HEWLFIDR) 

chart 119 
description of 40 


L ] 


I70 control table, address of text note 
list on SYSUT1 43, 47 
ordering of text 60 
I/0 flow 11-14 
ID-length list 43 
identification record 
See CSECT identification record 
IDENTIFY statement 
See also CSECT identification record 
general description of processing 24 
operation diagram 82 
processing data 41 
chart 
JRROeceser 29 


See CSECT identification record 
IDR data types 
IMASPZAP-supplied data processing 40 
linkage editor data processing 40-41 
translator-supplied data 
processing 39, 40 
chart 117 
user-supplied data 41 
See also IDENTIFY statement 
processing 
Processing chart 120 
IDR tables 57 
See also CSECT identification record 
written onto SYSLMOD 
translator data table CIDRTRTAB) 
contents 47 
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entry 41 
user data table CIDRUDTAB) 
contents 4] 
eee processing CHEWLFINC) 10, 93, 


INCLUDE statement 24 
See also include processing 
general description of processing 24 
in input processing 
operation diagram 82 
processor 
incompatible module attributes 20 
initialization processing CHEMLFINT) 
description of 15, 
synopsis 89 
operation diagram 77 
input 
See automatic library call, SYSLIN 
data set 
input conventions 194 
input data set 
See SYSLIN data set 
input entry types 
See input record types 
input processing CHEMLFINP) 
description of 15-16, 22 
chart 2 
synopsis 90 | 
operation diagram 78 
overview 11-14 
input record types 
associated processors 91 
formats 195-206 
general register contents for 33 
Processing 22, 3 
input text buffer (TXTBFBEG) 
general description of use 16, 18 
in single pass processing 
in text processing 41, 43 
minimum length 21 
input/output flow 11-14 
INP270 
See load module processing 
INSERT statement 


general description of processing 24 


operation diagram 82 
processor | 
intermediate output processor CHEWLFOUT) 
description of 16-17, 57 
synopsis 94 
use of hierarchy table 28 . 
intermediate processing 
description of 16-17, 51-56 
charts 127, 132 | 
synopsis 94 
objectives 16 
operation diagram 79 
overview 


label definition (LD) 
definition 
entry processing 34 
nonresolution processing 37 
label reference CLR) 
definition 34 
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nonresolution processing 37 
resolution processing 38 
label routine 38 
eee translators 1 


See label definition 
LET option 
level 8 symbol 24 
See also control statement 
operands 
level 1 symbol 24 
See also control statement 
operands 
library calls 
function 1 
library read block G48 
LIBRARY statement 
in automatic library call 
processing 50, 51 
See also automatic library call 
in input processing 
operation diagram 82 
processor 30 
line number 4, 36 
See also CESD identifier, ESD 
identifier 
linkage editor 
data 
See IDR data types 
data sets 1] 
description 2-3 
design points 1-2 
entry point CHEPMLFROU) 89 
functions 
method of operation 15 
options 5-6 
organization 89-145 
overlay structures 2 
purpose 1-2 
relationship to the operating 
system 
linkage editor assigned address of first 
text record as zero 
linking object modules 2 
LIST option 6 
load module 
attributes 6, 8 
See also attributes, module 
data set . 
See SYSLMOD data set 
definition 3 
processing CINP270) 
description of 32 
description of chart 104 
description of synopsis 91 
record types 
See also input record types 
structure 3-5, 6-11, 16-18 
text processing 43 
See also text record processing 
logical record length CLRECL) 
for SYSLIB 23 
for SYSLIN 23 
for SYSPRINT 23 
for SYSTERM 23 
ooze record 43 


See label reference 


LRECL 
See logical record length 
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MAP option 6 
See also MAP/XREF processor 
function 6 
general description of 
Processing 16~17 
in intermediate output processing 58 
MAP/XREF processor (CHEWLFMAP) 
description of 59 
chart 132 
in program organization 94 
map, module 1 
See also MAP option, MAP/XREF 
processor, options 
contents 17, 58 
production of 13, 58 
chart 132 
in program organization 94 
member name for SYSLMOD data set 
messages 14 
See also diagnostic aids 
microfiche directory 146 
MODE statement 
general description of processing 24 
MODE statement processor 
module 
origin 2 
structure 2-5 
module attributes 
See attributes, module 
module map 
See map, module 
module—CSECT cross-reference table 149 
multiplicity 
in relocating address constants 72 
read into input text buffer 41 
writing on SYSLMOD 60 
writing on SYSUT1 43 
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NAME statement 
general description of processing 24 
in final processing 72 
in input processing 22, 49 
operation diagram 
processor 28 
NCAL option 
See also automatic library call 
function 
in input processing 22, 49 
NE (not editable attribute) 8 
no-length control section 42, 93 
nonresolution processing 36-37 
not editable attribute (NE) 8 
note list (for overlay segments) 10 
null type 
changing CESD entries to 5l 
definition 34 
entry processing 36 
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object module 
definition 
processing CHENLEMDID 
description of 32 
description of?synopsis 90 
record types 31 
See also input record types 
structure 37-5 
text processing 42, 43 
See also text record processing 
object module buffer 15, 
OL Conly loadable attribute) 7 
opening data sets 20 
operation diagrams 15, 75-88 
options 
analysis of CHEWLFOPT) 19, 89 
diagnostic output 5, 6 
See also LIST, MAP, TERM, XFER 
options 
introduction to 2 
processing 5, 6 
See also LET, NCAL, XCAL options 
space allocation 
See also DCBS, SIZE options 
specification of 6 
ORDER statement 
and ALIGN2 attribute /7 
processor 29 
ORDER table 
creation 29 
diagrams 78 
in address assignment 52, 53 
in END processing 
in intermediate output 59 
diagram 79 
layout 182 
out of order text 42 
use during text processing 42 
output load module data set 
See SYSLMOD data set 
overlay format attribute COVLY) module 
characteristics 
overlay module processing 2 
See also OVERLAY statement 
description 2 
relocating V-type address 
constants 
OVERLAY statement 
general description of processing 24 
operation diagram 
processor 


See overlay format attribute 
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P Cposition) pointer 
definition 
in entry table size determination 54 
updating 16 

PAGE statement 
and ALIGN2 attribute 7 
general description of processing 24 
processor 29 

partitioned data set (PDS) 
directory entry for SYSLMOD 18, 72 
generating a load module in 2, 6 
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include processing for 48-49 
SYSLIB data set 
“ SYSLMOD data set 12, 13 
P 
See private code 
PDS 
See partitioned data set 
position pointer 
See P pointer 
PR 
See pseudo register 
private code (PC) 
definition 34 
entry processing 34, 35 
marked delete 34, 52 
PROCENTY routine 25 
program 
organization 89-145 
processing history 1 
pseudo register 
address assignment 18 
computing cumulative PR length 53 
definition 
in RLD processing 44, 71 
purpose of the linkage editor 1 
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R Crelocation) pointer 
definition 
in entry table size determination 54 
updating 16, 44 
RCT 
See relocation constant table 
RDRLD 
See RLD read routine 
RDTXT 
See text read routine 
read control block 
for SYSLIN 22 
read only control section 8 
READ8 routine 
chart 123 
in control statement processing — 25 
in program organization 93 
record 
See also ESD record 
dense (contiguous) 43 


formats 195-206 
loose (noncontiguous) 43 
types 


See input record types 
record types 
LIST used in construction 180 
on SYSPRINT data set 12, 13, 14 
See also SYSPRINT data set 
on SYSTERM data set 12 
See also SYSTERM data set 
TABLE used in construction 180 
recovery management routine and 
refreshable attribute 6 
reenterable attribute CRENT) 6 
REFR 
See refreshable attribute 
refreshable attribute (CREFR) 6 
registers, contents of 31-33 
load module processing 33 
object module processing 3] 
relative relocation 
definition 18 
in entry processing 56 
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marking RLD item for 44 
relative relocation factor 
determination of 45, 54 
general description of use 18 
use in determining buffer relocation 
constant 7] 
See also relocation constant table 
RELOCATE routine 
See relocation routine 
relocation 
of address constants 17-18, 61 
See also address assignment 
processor, address constant 
of RLD items during intermediate 
output processor 59 
relocation constant 17, 18 
relocation constant table CRCT) 
contents 17, 18 
format 174 
making an entry in 52 
relocation dictionary (CRLD) 
and text processor CHENLFRAT) 92 
See also text and RLD processor 
contents 4 
introduction to 4 
processing CRLDOO]) 
description of 4%4-47 
description of chart 112 
description of synopsis 92 
operation diagram 86 
record 
See RLD record 
relocation pointer 
See R pointer 
Relocation routine CRELOCATE) 
description of 
in program organization 95 
RENT Creenterable attribute) 6 
renumbering table CRNT) 
contents 16 
format 174 
production of 35-39, 92 
use of 35, 40 
REPLACE statement 
general description of processing 24 
processor 
replace/change chain in the CESD 28 
See also CHANGE statement, REPLACE 
statement 
residence mode 1] 
residence mode CRMODE) 8 
resolution processing 37-39 
REUS Creusable attribute) 7 
a ae attribute CREUS) 7 
See relocation dictionary 
RLD buffer 
first pass 16 
general description of use 16, 18 
in single pass processing 60 
RLD control block 
initialization CHEWLFREL) 95 
input control block 
format 171, 175 
output control block 60 
format 175 
RLD flags 
in relocation address constants 
(table) 45-47 
RLD input buffer 
See second pass RLD input buffer 
RLD note list 
format 177 
introduction to 13 
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16, 44-47 
60, 94 


making entries in 
reading from SYSUTI 
RLD Processor 
use in locating RLD records. 60 
use in relocating address 
constants 72 
RLD output buffer 
See second pass RLD output buffer 
RLD pointers 4, 92 
See also P pointer, R pointer 
RLD read routine C(CRDRLD) processing | 
chart 138 
in program organization 95 
RLD record 
created for overlay 6] 
format 203 
in load module 32 
in object module 31, 32 | 
processing (RLDOO1L) 16, 446, 47. 
See also relocation dictionary 
processing 
RLD set 
definition 71 
use in relocating address 
constants 71 | , 
written on SYSUT1 44, 46, 47 |. 
RLD write routine Con SYSUT1) CRLDBUF) 
chart 114 
in program organization 92 
RLD/control record 
See control/relocation dictionary 
record 
RL DBUF 
See RLD write routine 
RLDOOL 
Siiaere relocation dictionary, processing 


See renumbering table 
root segment 
in overlay module 10 
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scatter format attribute (CSCTR) 
grouping control sections 60 
in processing example. ll 
module characteristics 7 
scatter loading 
See scatter format attribute. 
scatter table a 
format 201 
introduction to 1] 
production of 17, 58 
scatter/translation record 
format 201 
function 7 
introduction to ll 
written on SYSLMOD 58, 94 
SCDENTAB 
a entry table creation routine 


see scatter format attribute 


See section definition 
second pass processing CHEWLFSCD) 
description of 
charts 135 
Synopsis 95 
objectives 17 
operation diagrams 80, 88 
overview 13 
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second pass RLD input buffer 
reading RLD records into 
use in relocating address 
constants 72 
second pass RLD output buffer 
entering RLD items in 18, 60 
use in relocating address 
constants 7] 
second pass text buffer, reading text 
records into 
second pass text control block 
format 178 
initialization CHENLFREL) 95 
second pass text control table, making 
an entry in 
section definition (SD) 
definition 34 
nonresolution processing 36 
resolution processing . 38 


18, 60 


SEGLGTH 
format 179 
introduction to 17 


processing 53 
segment path table CSEGTA1) 
in entry table size determination 54 
making an entry in 93 
processing 53 
purpose 2/7 
scanning by common path routine 38 
use in entry table creation 
segment relocation constant CSRC) 
definition 53 
introduction to 17. 
segment table (SEGTAB) 
determining the size of 94 
format 180 
introduction to 10 
PC-delete entry for 34, 53 
production of 17 
SEGTAB 
See segment path table 
SEGTAI] 
See segment path table 
serially reusable attribute CREUS ) 7 
SETCODE statement 
general description of processing 24 
SETCODE statement processor 31 
SETSSI statement 
general description of processing 24 
operation diagram 
processor 28 
Single pass processing 
description of 18, 60 
occurrence 18, 
SIZE option 
function 6 
requesting additional buffer 
Space 21] 
ebecnes event processing 31, 32 


See segment relocation constant 
storage allocation 15, 21, 22 
See also allocation 
STOW macro instruction 
entering name in PDS 14, 18 
issuing 72, 95 
SYM record 
See symbol record 
symbol (SYM) record 
format 195, 199 -. 
in output load module. 
processor (CHENLFSYM) 
chart 105 
Synopsis 9] 


9, 16 
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special event processing for 3] 
SYNAD routine CHEWLCRO1) 

chart 14940, 144 

Synopsis 96 

use of 23 
SYSLIB data set 

definition 12 

in input processing 15 

opening 20 


opening DCB in include processing 48 


resolving ERs from 
with automatic library call 
processing 20, 50 
SYSLIN buffer 16 
SYSLIN data set 
opening 20 
processing after termination of 
input : 
with automatic library call 
Processing 22, 49 
SYSLMOD data set 
definition 12 
in program organization 91, 94 
member name 
opening and determining block 
size 
writing on 57, 72 
SYSPRINT data set definition 12 
directing diagnostic messages to 73 
opening 
output block size 23 
writing cross-reference table on 94 
system status index 
SYSTERM data set 
definition 12 
device requirement 12 
writing text on 43 


table 
allocation 22, 188 
temporary linked address 52 
temporary relocation constant added to 
SRC 52 
computation of 52 
TERM option 
function 6 
in final processing 73 
processing 
terminal data set 
See SYSTERM data set 
TEST attribute 
function 7 
in input processing 13, 91 
in object module processing 32 
in processing example 11-13 
testing symbol dictionary 9 
See also symbol record 
text (TXT) record 
contents 10 
dense 43 
format 197 
in load module 32 
in object module 31 
loose 43 
processing CHEWLFTXT) 
chart 110 
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description of 16 
operation diagrams 84, 85 
synopsis 92 
RLD processor CHEWLFRAT) 92 
See also text and RLD processor 
text and RLD processor CHEWLFRAT) 92 
See also relocation dictionary 
processing 
chart 109 
synopsis 92 
text buffer 
See input text buffer 
text control block 
See second pass text control block 
text I70 control table 
See text I/0 table 
text I/0 table 
contents 16, 17 
format 181] 
making an entry in 42, 43 
use during address assignment 52 
use during intermediate output 
processing 59 
use during processing 16-17 
use in ordering text 60 
use in reading from SYSUT1 59 
text note list 
format 18] 
making an entry in 42, 43 
reading from SYSUT] 60, 94% 
use during text processing 42, 43 
use of 7 
Text read routine CRDTXT) 
chart 138 
in program organization 95 
Text write routine Con SYSLMOD) CNRTTXT) 
chart 139 
in program organization 95 
Text write routine Con SYSUT1) CTXTBUF) 
chart 111 
synopsis 92 
translation of input IDs 35 
translation table 
format 201 
introduction to ll] 
production of 58 
translator-supplied data 40 
See also IDR data types 
processing 40 
chart 117 
TTR list 
contents 18, 61 
creation of 6] 
writing on SYSLMOD 72, 95 
two pass processing 
TXT record 
See text record 
TXTBFBEG 
See input text buffer 
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unlike attributes indicator 20 
upward calls 54 
user-supplied data 41 
See also IDR data types 
Processing 41 
chart 120 
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V-type address constant 
description of 18 
entered in calls list 16 
in RLD processing 45 
relocation of 61, 66 
virtual storage allocation 
description of 15, 21 
release of 72 
virtual storage allocation table 169 
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weak external reference CWX) 
definition 34 
nonresolution processing 3/7 
resolution processing 

weight factor 169, 188 
See also virtual storage allocation 
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WRTCRRLD 

See control/RLD record write routine 
WRTITXT 

See text write routine on SYSLMOD 


See weak external reference 
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XAD2ZCESD table 182 
See also cross-reference table 
table used in the production of 182 
XCAL option 
XDAP macro instruction 60 
XREF option 
function 6 
general description of processing 17 
in final processing 
in intermediate output processing 94 
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